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NEXT 
MONTH 


We are still restraining a review of 
PROSPERO PASCAL for 
programmers, a ONE MAN’s SYSTEM 
about Archive, lots of reviews 
including several low-cost utilities, and 
a user report on the CV1 digitiser, as 
well as machine code programming 
ideas from DIY Toolkit and Alan 
Bridewell. 


Bryan Davies 
assesses the 
advanced state of GL 
word processors and 
front ends and asks: 
what next? 


ith Perfectionnow well-known, 
and an upgraded text®’ intro- 
duced, it may not seem the 
obvious time to ask for com- 
ments on what you feel is still missing from 
the available wp programs, but it is desir- 
able to ‘get your oar in’ early if you want to 
influence future developments of wp pro- 
grams for the QL. There is still much 
improvement to be made in wp programs 
for any microcomputer. It may be that wp 
and dtp will gradually merge; wp programs 
are certainly moving closer and closer to 
dtp programs in their capabilities. Like it or 
not, the bigger market outside the QL 
scene will tend to set the pace for us, and 
we can expect the introduction of such 
features as wimp interfaces (provided 
enough QL users keep on buying software 
to make it worthwhile suppliers staying in 
the market). 


Graphical interfaces 


There seems little doubt that the Apple 
Macintosh is the leader in the use of graphi- 
calinterfaces. Running to catch up are the 
Microsoft Windows-based programs on 
the PC. My own recent experience with 
Windows and the matching wp program 
Word For Windows is that they both leave 
a great deal to be desired (as does the 
technical support}. This does not alter the 
fact that these programs point the way we 
are likely to go (ie be taken); it is just that 
they don’t (to my mind) make a good job of 
helping the user get on with work. There is 
a considerable emphasis on gimmicks — 
interesting, but no use if you have work to 
do. This may be a reflection of life in the 
1980s and 90s in general: we have to have 
pretty pictures and buttons to press, even 
ifthis means ittakes longer and more effort 
to perform a desired function. 

In case wimp and gui don’t mean any- 
thing to you, here’s a brief summary of 


their meaning and intent. They are essen- 
tially the same thing. Wimp stands for 
windows, icons, mouse and pull-down 
menus, gui for graphical user interface. 
Different programs, or different parts of 
the same file, can be displayed running in 
separate areas of the screen, simultane- 
ously. Programs, files and actions are 
displayed in the form of small pictorial 
representations of themselves, such as a 
square, white object with horizontal black 
lines across it to indicate a text document 
(file). Basic menu names are shown on 
single bars, typically across the top of the 
screen, and the options for a menu are 
displayed on a panel which ‘drops down’ 
(or is ‘pulled-down’) if the menu name is 
selected. The mouse steers a pointer; 
selecting a menu or option is done by 
moving the pointer onto the icon for the 
menu or option and pressing a mouse 
button to select it. Programs are started by 
pressing the mouse button twice (‘double- 
clicking’) when the pointer is on the pro- 
gram icon. Rather than typing textin ona 
command line, as with Basic, the idea is to 
use a mouse to point-and-click on clearly- 
identified areas of the screen, to obtain the 
same functions. A simple example is dele- 
tion of a file; instead of typing-in the delete 
command and the full device, path and file 
name, then pressing ENTER, you move 
the mouse until its pointer lies on the icon 
identifying the file concerned, clicka mouse 
button to ‘mark’ that file, then move the 
pointer to the delete option on a pull-down 
menu and click again. Better still, with the 
Mac and some other micros, you point to 
the file and hold the mouse button down 
while ‘dragging’ the file to a rubbish bin 
(trash can) icon, then release the button 
with the pointer on the bin to delete the file. 


Easy access 


The aim is to make hard-to-remember 
commands easy to access. This will cutno 
ice with hackers who pride themselves on 
knowing all the Basic and program com- 
mands, and use them often enough not to 
forget them, but many users have neither 
the ability nor the interest to learn com- 
mands which are often less than clear. 
Evidently, we are — to some extent — being 
dragged along a path that is being created 
primarily for wp operators in offices. How- 
ever, many home micro users will be quite 
happy to have their computer life made 
easier for them this way. 


While the mouse has been an integral 
part of the graphical interface all along, the 
user is normally given the option of select- 
ing operations from the keyboard. In gen- 
eral, selection is quicker by key than by 
mouse. A mouse sounds a great idea until 
you actually use one in earnest; it then 
tends to feel distinctly cumbersome. Fora 
fast typist, the mouse can be a deadly 
enemy, since its use entails removing a 
hand from the keyboard, thereby destroy- 
ing the rhythm of typing; you can hardly 
keep up 120 words per minute typing 
speed with one hand periodically being 
‘lost’. To be fair to the mouse, the flow of 
typing is interrupted anyway whenever a 
command has to be selected from the 
keyboard. Whether or not the user takes to 
the mouse depends to alarge extent upon 
how easily and quickly functions can be 
accomplished by mouse, and how memo- 
rable the alternative keyboard actions are. 
To return to Windows and Word For Win- 
dows, the former has plenty of quite forget- 
table key combinations, whereas the latter 
has several eminently sensible ones. 
There’s no great problem remembering 
Ctrl-B to switch on or off the Bold text 
attribute, but what about Alt-down cursor 
to open alist of options ina menu window, 
then up/down cursor to identify the option 
required, then Alt-up/down cursor to se- 
lect that option? Depending on the type of 
menu displayed, the key combinations 
vary, just to make life more confusing. My 
own reaction was to immediately abandon 
any thought of using the keyboard for the 
one program, but to use it for the other; not 
exactly a consistent user interface. 


Well managed 


On the QL, Qpac is the equivalent of | 
Windows, having quite a lot in common 
with it. Qram or Qpac users will be familiar 
with many mouse‘actions, although some 
dragging and resizing functions may not 
be available to them in the most intuitive 
form. Both programs are Managers, defi- 
nitely with a capital ‘M’. They effectively 
take control of the computer, and other 
programs and users have to live by their 
rules. Ideally, from the point of view of 
Qpac, applications programs should be 
written (or rewritten) to be compatible with 
— and make full use of - Qpac. To avoid 
extensive keying, a mouse is virtually es- 
sential, and we don't have a ‘common 
mouse’ for the QL. The Quanta effort to 
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produce its own Qimi mouse interface, 
with some software improvements, suf- 
fered some delays, and Qimi is not com- 
patible with many existing (and important) 
application programs anyway. We 
shouldn't forget /ce either, as that was 
really the first useful, and usable, wimp 
interface for the QL; a great pity it was not 
developed to provide other functions, such 
as wild-card copying, dragging icons for 
copying and deletion, double-clicking on 
files to automatically start the program 
they were created in and load the files etc. 

Returning to the initial pointin this article, 
if you have strong feelings on how both 
programs and the user interface should be 
developed, let us know. 


Fancy stuff? 


Users of Quill may say ‘why bother with 
all this fancy stuff?’, and | tend to agree, /f 
you use (and are satisfied by) just that one 
program. The limited facilities it provides 
are obtainable without too much pain from 
simple keyings. By-and-large, the other 
Psion programs use the same keyings, 
making it unnecessary to remember differ- 
ent combinations for similar commands in 
each program. There would not have been 
such a large variety of alternative pro- 
grams produced for the QL if Quilf had 
been thought satisfactory by everyone, 
though. The demand for additional func- 
tions in individual programs, and for the 
ability to have several programs available 
quickly, at the touch of a couple of keys, 
has brought us to a much higher state of 
software development. Serious users will 
not want to stop there, either. The more 
non-Psion programs one uses, the greater 
becomes the headache from trying to re- 
member the key combinations for com- 
mands. This is one problem that the Win- 
dows interface has tried to overcome; the 
idea is that a/! programs will utilise the 
same menu structure. When you start any 
program, it will have essentially the same 
menu bar across the top of the screen, and 
most of the same options will appear on 
the drop-down menus. The user is, there- 
fore, able to use any program — even one 
newly-installed — without having to read- 
up on key combinations for commands. 
Surprisingly enough, it works quite well in 
practice. Can we reasonably hope for 

| something like it on the QL, one day? 

Graphical user interfaces suffer from 
being slower than text ones, but the Gold 
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Card and HD/ED floppy drives or hard disk 
have now given the QL the necessary 
speed to handle the graphics operations 
better, and the non-graphics operations 
much better. 


Readers’ letters 


David Cottom enquired about a prob- 
lem he had printing from text’ to an Epson 
GQ-5000 laser printer. The problem was 
that text was not being wrapped at line- 
ends. As he uses a serial-to-serial link 
from QL to GQ, his system is not quite 
comparable with mine, on which the serial 
port output is converted by a Miracle se- 
rial-parallel interface and fed into the par- 
allel input on the printer. One reason for 
not using the serial input is the relative 
complication of setting it up; you have to 
set word length, Baud rate, parity, stop bit, 
DTR, XON/XOFF, DSR, CTS, and RX 
buffer. Don’t ask me to explain all these: 
with the parallel input, all you do is plug the 
cable in. There is another difficulty with 
using the serial input, in that you will need 
acable with the QL PCC connector on one 
end and a standard printer 25-pin ‘D’ con- 


“We can expect features 
like wimp interfaces, as 
long as QL users buy 
enough software ... many 
users will be happy to 
have their life made 
easier in this way.” 


nector on the other. Although there are 25 
pins onthe printer connector, the QLSER1 
and SER2 ports use only four wires, but 
not the same four. The only suggestion | 
could make to Cottom here was that the 
CTS function should be set Off on the 
printer, as the QL does not use that line for 
SER1. 

The more likely place to look for the 
failure to wrap lines is in text®’ itself. The 
original GQ driver worked well un/ess you 
set the Layout to get the maximum left and 
right margins; to the best of my recollec- 
tion, setting the left margin as close to the 
edge of the paper as possible resulted in 
no line wrap, but you could fix this by 
moving the left margin even one keypress 
to the right. This problem should not occur 


with later versions of the driver. 

A. Ingrey ordered a keyboard from Key- 
board Products and managed to get a 
refund for it after about four months (this 
was one of several orders we received 
complaints about and chased-up). He then 
ordered another keyboard from EEC Ltd 
in November 1990, and that appeared to 
get lost in the post; as of July 1991, he had 
received neither keyboard nor refund, al- 
though the latter was apparently being 
sought from the Post Office by EEC. So 
far, no reply has been received to my 
enquiry, from EEC. 


Lost information 


T.K. Computerware has had a hard 
disk problem recently (not with a QL unit, 
| believe) and this has caused some diffi- 
culty tracing information on orders, but 
they have supplied the following com- 
ments on letters sent to us. A.P. Campbell 
ordered the game Patience in June ‘91 
and wrote in July to say it had not arrived; 
T.K. had despatched the order, but it went 
to the wrong Campbell. The matter has 
now been sorted out. N.D. Mortier or- 
dered a book and some cartridges in May 
‘91 and got the book in June but had not 
received the cartridges as of mid-August. 
T.K. report sending the cartridges and 
receiving them back from the Post Office 
marked ‘not called for’; they were sent to | 
Mortier again, and he should have re- 
ceived them by now. Presumably the UK 
Post Office now has a standard policy of 
calling only once to deliver anything; if you 
are not in to receive items which will not go 
through the letter flap, or require a signa- 
ture to confirm receipt, the postperson 
should leave a notice advising you that the 
call has been made and giving details of 
where to go to collect the goods. 


Chess checked 


A.R. Kempton ordered the Psion game 
Chess in May ‘91. It was apparently des- 
patched but lost in transit. While it was 
being looked for, Psion decided not to 
produce any more Chess cartridges, partly 
because of the difficulty they were having 
getting cartridges and partly because there 
were too few orders to justify continuing 
the product. T.K. therefore refunded 
Kempton's money. Dirk van Rompuy or- 
dered an EPROM eraser and the ST-Z88 
link software in March ‘91. The order was 


despatched in two parts, in early April and 
early May. As of June, Rompuy said he 
had received only the eraser. Hopefully, 
the software has also arrived by now. 

A few suggestions on how to avoid 
some of the complaints made about sup- 
pliers: when leaving messages, make sure 
to leave an office ‘phone contact number 
as well as a home one (if you have both); 
make sure the expiry date you give with 
credit card details is correct (card compa- 
nies can turn down authorisation requests 
if even small account details are incor- 
rect); send valuable returned goods back 
insured and by a confirmed-delivery serv- 
ice. It may be that some buyers are receiv- 
ing less speedy service now than they did 
a year or so back, from the same supplier, 
and this really should not come as a 
surprise. Consider the general state of the 
UK economy (also those of many other 
countries) and ask yourself what most 
stockists of goods will have done in the 
past couple of years; for certain, they will 
have reduced stock levels, to keep their 
cash outlay down. Only when orders are 
received will they be placing orders with 
their suppliers, and the latter also are 
likely to keep less stock than before. De- 
lays are sometimes going to occur right 
down the chain. 

Another area where delay can occur is 
the gap between receipt of a cheque and 
despatch of the ordered goods. Whereas 


ASTRO (NICK WARD) (astrology prog) (128k) [fpimdv) £12.50 


D-DAY MKII (DOC & RICH MELLOR) wargame) (256k) (tip) £15.00 


GAEY WOLF [OLIVER NEEF) (u-boat simulator) (256k) (flp) £10.00 


OPEN GOLF (OLIVER NEEF) (golf simutator) (384k) (flp) £12.50 


PUDGE (DAMON CHAPLIN) arcade game} (128k) (fipimey) £12.50 


£10.00 


GUIP ART 1. SPORTS [FLP) £6.00 
CLIP ART 2 - WHIMSIES {FLP) £6.00 
CLIP ART 3 - OFFICE (FLP} £6.00 
CLIP ART 4 - Viz }FLP) £6.00 

GLIP ART 5 - GENERAL [FLP) £6.00 


SPEEDSGHEEN - ROM VEASION £20.00 
SPEEDSCAEEN - FLP/MDV £10.00 


THE BLAG? (TONY WOOLCOGK) (lex! adventure) (256k) [flp'mdv; £10.00 


HERE WE GO (PHIL JONES ANO ANDY CSERBAKON) (taxt aventura) (128k) (fipymovi £10.00 
MACSPORRAN’S LAMENT (DAVE WATSON) {illustrated text adverture) (128K) (tlamev) £10.00 


ORBITING STARS (JOHN TOPHAM) (astronomical simulator) (1 28/256K) [flp'mdv) £10.00 
PERSONAL FINANCE MANAGER (JASON VICINANZA) (budget systam) (128k} (tomoy) £10.00 
POLYTEXT (NICK WARD) (multi-column quill) (1282564) (fipéndv) €17,50 


QUICK MANDELBROT (KENNETH MURRAY! ifractals) {128k} (lo‘mov) £10.00 

QUIGK MANDELBROT & JULIA (KENNETH MURRAY) (fractals) (128k) (tomo) £12.50 
QUIZMASTER (PHIL JONES AND ANDY CSERBAKOI) (quiz game} {128k} (flpemdv) £10.00 
QUIZMASTER II [AS ABOVE & RICH MELLOA) (quiz game + module option} (128%) (fipimdy) £2 50 
RETUAN TO EDEN (OLIVER NEEF) (role-playing illustrated adventure} (256k) {flp) £17.50 
SCRIPTWAITER (ANDY PRITCHARD) {text processor) (256k) [flpimdy) £15.00 

SECTOR X (HORST SPIERLING] [shoot ‘am up] (256k) (ilp| £12.50 [mdv} £15.00 

SPEEDFREAKS [DAMON CHAPLIN} {car race game) (128k) (ilpmdy) £12.50 

SQUIDGY ROUND THE WORLD (MICHAEL CROWE) (arcade game) [fp £12.50 (dv £15.00 
STARPLOD (ALAN PEMBERTON ficon-driven adventure) (128k) (flo‘mdy) £10.00 

30 TERRAIN (JAN THOMPSON) (use abacus data to create 30 graphs) (128k) (lipmav) £12.50 
STOOL (ALAN PEMBEATON & RIGH MELLOF} ST 2G) (screen transter & image processor] (256k) [flp'mdy} 


UNCLE LOONIE’S LEGACY (DAVE WATSON) (puzzle adventure) (128k [flp’mdv} £10.00 
VOYAGE OF THE BEANO (ALAN PEMBEATON) (illustrated text adventure) (256k) (flp] £12.50 
WRECK DIVE (NICK WARD) larcade adventure) (128k) jtlp/mdy) £10.00 


some suppliers might, in the past, have 
sent goods as soon as the cheque was 
received, they will (if they are sensible) 
now be waiting long enough after acheque 
is banked to ensure that it does not 
‘pounce’. Banks claim, nominally, that 
cheques are cleared in two to three work- 
ing days, but this cannot be relied upon. 
One bank | deal with does not credit any 
cheque in under seven working days; that 
means a maximum of nearly twelve days 
before you can use the money if you make 
a deposit late on a Friday. A supplier 
cannot safely consider a cheque has 
cleared two to three days after it has been 


“There are less 
complaints about 
suppliers than there were 
... It’s heartening to see 
letters containing 
technical queries.” 


banked; it might re-appear as ‘returned’ 
some time late on the third day, orevenon 
subsequent days. Banks are now charg- 
ing far more for their (sometimes dubious) 
services than they used to do, and re- 
turned cheques are costly ones. A point to 
bear in mind regarding payment by credit 
card is that the total cost of single orders 
has to be charged as one transaction, 
even though the goods may be sent in 


C.G.H. SERVICES 


Cwm Gwen Hall, Pencader, Dyfed, Cymru, SA39 SHA (Tel. 0559 384574) (9am - Spm) 
COMMERCIAL SOFTWARE 


ANELPUM QUAT (NICK WARD) (text adventure) {124k} (lpmdv) £10.00 
ASSAULT AND BATTERY (DAMON CHAPLIN) (shoot 'em up) (128k) [flpimdv} £12.50 


DOUBLE BLOCK [FRANCOIS LANGIAULT) {arcade gama) (128k) {flp'mdy) £10.00 

DREAMLANDS (JEAN-YVES ROUFFIAC) (text adventure) (256k) (fo) £10.00 

EPIC AOVENTURE (ANDY PRITCHARD} [illustrated adventure) (256k) (flp) £12.50 

FIVE GAMES PACK 1 (WREFORDO DAVIES) (mind games} (128k} (flp) £12.50 

FRAGTALS FROM NEWTONS METHOD (JGHN TOPHAM (fractals) (128k) (fip'mdy) £12.50 

FROM THE TOWER OF VALAGON (ALAN PEMBERTON) (text adventure) (128k) (llorrdy) £10.00 
GEE-GEE SYSTEM (PHIL JONES AND ANDY CSERBAKQOI) (race predictor] (128%) (fipymev) £10.00 ¥ 
AUSTRALIAN P.D. DISKS 1 + 2 (includes a wide variety of ganas, utilities e1c) 
COMMUNICATIONS DISK 7 [includes GQBOX Bulletin Board system| 

COMMUNICATIONS DISK 2 [includes OL Kernut) 

CONNECTIONS OISK 4 [includes ST - GU screen and fil converters} 

DEVICE UTILITIES DISK * jinetudes Archiving. compacting, formating and Shell pragranss) 
DILWYN JONES OISK | [includes many Super Base progs and Wordsearch) 

EDITORS DISK 1 (includes QED and MicroEmacs} 

EDUCATIONAL PROGRAMS DISK 1 (ndudes malhs music and cnemustry programsl 
EMMANUEL VEABEECK DISK 1 jincludes screen save and print progs and many more wtilltias) 
ESOTERICA DISK 1 [includes DIY Pyrarnid canstrection prog. Groryihms and Psychology peogs) 
FRACTALS OISK 4 |intudas large numbers of mandelbrot and other tractal prags) 

FRACTALS DISK 2 |Carl Grorun's mandelbrat prog plus animation screens} 

FRACTALS OISK 3 (Rainer Kowallick’s mandelbrot prog as amended to give "Jewel' effect) 
GAMES DISK 1 |inctudes Starburst, Cavern Frenzy) 
GAMES DISK 2 [inciudes ma‘y arcade type games) 
GAMES OISK 3 pneiudes QL War) 

GERMAN TO ENGLISH GICTIONARY {mulil-taskng) 
GRAPHIX ANIMATION OISKS 1. 2, 3, 4, 5 [TY Movies) 


GRAPHIX DEMOS DISK 1.3.4 


Pigase note the above are only part ot our P.D. Library. New programs are constantly baing added and mora are always 
welcome. Please send an S.A.E. for tull catalogue. 

We can also supply commercial software for STs and Armigas! 

ALL PRICES INCLUDE MEDIA ANG POST AND PACKING FOR THE UK. 
PLEASE ADD 10% FOR ORDERS IN EUIACPE. 20% OUTSIDE OF EUROPE 
PLEASE INGICATE 3.5°/5.25'-MDV VERSIONS WHEN ORDERING 


PUBLICATIONS 


QL TECHNICAL REVIEW (SSUES 1-2 £7.50 EACH 

‘OL TECHNICAL REVIEW ‘SSUES 3-6 £1.75 EACH 

QL ADVENTURERS FORUM ISSUES 1-3 £1.25 EACH 
QL ADVENTURERS FORUM ISSUES 4-9 £1.50 EAGH 
OL LEISURE REVIEW ISSUE 1£1 75 EACH 
INTERNATIONAL GL REPORT ISSUES 1-2 £1.50 EACH 
OL SURVIVOR'S SOURCE BOOK £2.50 EACH 


PUBLIC DOMAIN AND SHAREWARE LIBRARY 
ALL DISKS £2.00 EACH INCLUSIVE OF MEDIA AND P&P 


ADVENTURE GAMES DISK 1 jintudes faniasia and ye dassical type agverdure) 

ADVENTURE SOLUTION DISKS 1-3 (includss The Pawn and Martvilla Manor. mainly ST taught} 
ADVENTURE SOLUTIONS DISK 4 (QL spacifc) 

ADVENTURE GAMES SOURCE CODE DISK 1 (includes Fantasia. Maunlod Mouse, ate) 
ADVENTURE UTILITIES DISK [includes Quill to SuperBasic converter and demo adyvardure) 


GRAPHIX SCREENS [FIF FORMAT) DISKS 1. 2,9 

GRAPH'X SCREENS IPIX FORMAT) DISK 1 

GRAPHIX SCREENS [SPECTRUM] DISK 1 

GRAPHIX SCREENS (ST) DISKS 1, 2,3.4,5.6, 7,9 

GRAPHICS'SCREEN UTILITIES DISK 4 [includes sorte Gasigner. CAD ard window progs.| 
HAM RADIO DISK 1 (includes PC conversions) 

INDEXES DISK 1 (includes calculator pi and calendar creator proge.i 

OLIVER FINK DISK 1 {includes progs requiring Pointer anviroriment ta work! 

PRINTER UTILITIES OISK 1 (ndudes label creators and printer tutorials) 

PROGRAMMING DISK 1 (includes OL PROLOG) 

PROGRAMMING DISKS 2 - B (C65 Comper 

RALF BIEDERMANN DISKS 1 +2 (excellent callackon of programs, games. utilities. etc. | 
RECREATIONAL MATHS DISK [includes life callusar automatons ech 

SUPERBASIC UTILITIES DISK 1 (includes large numbers of utility progs, toolkds, procedures 4c) 
TEXT DISKS 1-7 (The Bible - Old Testarnerti 

TEXTDISK 15-16 (The ible - Naw Testament) 

TEXT DISK 14 (400+ Business Letlers fram U S.A.) 


more than one package, atdifferenttimes. 
This is the way the card companies re- 
quire the supplier to do business. It may 
mean you get part of an order but are 
charged for the whole order; if there is 
then some problem with shipment of the 
rest of the order, you stand to be out of 
pocket for that partof the order until checks 
have been made on the missing item(s). 


New owners call 


There are many less complaints about 
suppliers than there were even a year 
ago. Although the general drop-off in QL 
business, and the recession, must have 
been major factors in this change, it is 
heartening to see most letters containing 
technical queries rather than complaints 
now. For one reason or another, the less 
reliable suppliers have largely left the 
scene. A significant portion of current let- 
ters appears to come from new QL own- 
ers, who often ask questions that have 
been answered in these pages several 
times before. Older readers should bear 
in mind the problems they had getting 
information, years ago, when tempted to 
object to repeated bits of advice! There 
are less sources of help now than there 
were then and we feel it is our job to assist 
the new user. It is to the benefit of all of us 
to have more users buying more products 
and helping to keep the QL world healthy. 


HES CENE 


Psion UK have come up witha 
new pocket computer - the 
Series 3. The diminutive, ‘clam- 
shaped’ computers, 
approximately 6 x3x.75 inches 
in size, not only improve on 
the well-known Psion Organ- 
iser range, but advance and 
extend the technology and ca- 
pabilities of pocket computing. 

Coming in two versions, a 
128K at £199.95 and a 256K at 
£249.95, the computer arrives 
complete with seven applica- 


tions programs including a 
database, a word processor, an 
alarm, diary and time planner, 
a calculator, a telephone tone 
dialler and the programming 
language OPL. Itcan multitask 
programs and has its own win- 
dow graphics operating 
system, using the built-in 240 
by 80 pixel Icd screen. It also 
has acommunications port giv- 
ing it the capability of 
exchanging data with desktop 
computers and printers, and 


CARE OFFER 


Care Electronics are doing a 
special offer on Qpac 2 during 
January and February 1992. 
From the beginning of January 
to the end of February you can 
save £10 on the normal price of 
Qpac2 by paying £39.48 plus 


£2.35 post and packing. Some- 
thing to spend your Christmas 
money on! Contact Care at 800 
St. Albans Road, Garston, 
Watford, Herts WN26NL. Tel. 
0923 894064 for orders and in- 
formation. 


Family 
Format 


What's this? It seems that the 
All Formats Computer Fairs 
have got themselves a lovely 
blonde toassist them with their 
publicity. But they are keeping 
it in the family — the lady is 
graduate technology designer 
Christian Riding, daughter of 
long-standing Fair agent John 
Riding, he of the advance tick- 
ets and stand sales. 

“Christian is hard-working, 
dynamic and outgoing, quali- 
ties that will help ensure the 
continued success of the Fairs,” 
says owner and organiser 


Bruce Everiss — qualities which 
also characterise the dedicated 
programmers, suppliers, pub- 
lishers and contributors of the 
QL Community, some of whom 
are nearly as attractive as Ms 
Riding, too, in the right light! 

Dates for forthcoming fairs 
are: Motorcycle Museum, op- 
posite the NEC, M46 junction 
6, 11 January; University Sports 
Centre, Leeds, 12 January; Hor- 
ticultural Hall, Westminster, 
London (the fair most likely to 
attract OL support), 18 January; 
Brunel Centre, Templemeads, 
Bristol, 19 January; City Hall, 
Candleriggs, Glasgow, 26 Janu- 
ary. Fairs run from 10am to 
4pm and admission is £4, Ad- 
vance ticket sales and 
information from John and 
Christian Riding on 0225 
868100. 
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New pocket machine from Psion 


can be expanded to 4 mega- 
bytes using the optional plug-in 
solid-state disks. 

We understand that it will 
communicate with the QL and 
we expect to be publishing a 
review soon. 

For more details of the Series 
3, contact Psion UK, Alexan- 
der House, 85 Frampton St., 
London NW8 8NQ. Tel. 071 
258 7368. 


QOL Contact France have con- 
tacted QL World to say that 
they are still alive and well. Get 
in touch with them at QL Con- 
tact France, 38-40 Rue 
Stephenson, 75018 Paris, 
France, 
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PEN GHANNWEL 


Open Channel is where you have the 
opportunity to voice your opinions in 
Sinclair QL World. Whether you want to ask 
for help with a technical problem, provide 


somebody with the answer, or just sound off 
about something which bothers you, write 
to: Open Channel, Sinclair OL World, 
116/120 Goswell Road, London EC1V 7QD. 


lam writing to you first to con- 
gratulate you on keeping QL 
World as interesting as ever and 
secondly to ask if itis possible 
to include even more informa- 
tion for the novice. 

Although I have had a OL 
since they first came out, lam 
still having difficulty with 
finding out how to do things. 

As weall know, the manual is 
not a lot of help, due to many 
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misprints and wrong informa- 
tion. 

[ must say that nearly all the 
things I have learned have 
come from the OL User/QL 
World magazines. 

In my case, I use Archive ex- 
tensively, and one of the best 
things that ever happened to 
me was the publication in Oc- 
tober, November, December 
1985 of the OL User Owner's 
Manual series, and the inclu- 
sion in part three of the Stamp 
Collectors’ program. I do not 
collect stamps~—but I have been 


able to adapt this program to 
cover twenty-seven other 
items, including such things as 
books, house contents, record 
collections, etc. 

Although the current New 
User Guide is a good idea, and 
very helpful, it does not, as yet, 
go quite so far as including 
programs that can be adapted 
as above. 


A R Kempton 
Polygon 
Southampton 


Everyone knows that backing 
up all your disks on a regular 
basis is the only way to guar- 
antee that all your effort is not 
in vain. Wrong! I keep three 
copies of my Archive pro- 
grams, and the data. One day I 
got the bad medium message 
on the work disk. After 
reformatting the disk and 
copying a backup onto it, the 
same message came a week 
later at a different place when 
the disk was loading. After this 
happened about four times, I 
jumped to all kinds of conclu- 
sions — dirty or misaligned 
heads, maybe, or even a disin- 
tegrating circuit. 

I formatted the problem disk 
onmy Archimedes, which dis- 
played a list of bad sectors as it 
formats and automatically 
reformats until as many sec- 
tors as possible can besalvaged, 
then maps the rest out. After 
verifying that all the sectors 
were good, the disk was set 
aside for abouta week and was 
verified. A number of bad sec- 
torsshowed upagain. That disk 
was retired to the circular file 
on the floor. 

The second time that hap- 


pened with a program disk, 
the reason dawned on me (I 
hope). They were the first disks 
Iboughtafter acquiring the disk 
drives in 1987, The magnetic 
material on the disk surface 
could not retain its magnetism 
for so long any more. 

Like microcassettes, disks 
wear out in time. It just takes 
longer; | wonder if that is also 
true for hard disks as well? 


J Paul Bissonette 
Otterfing 
Germany 
Editor's comment: Are these 3.5 
in disks or 5.25 in disks? That 
information would be of interest. I 
have heard of cassette tapes made 
in the 1970s which began to show 
significant deterioration within 
five years, regardless of theamount 
ofuse received, whereas tapes made 
more recently, when tape technol- 
ogy had advanced somewhat, still 
functioned well after many more 
years. The 3.5 in disk units are 
more modern, inherently more 
rigid and better protected from 
outside influence than 5.25 in 
disks. The same is true for hard 
disks, but moreso. 

It’s unwise to assume that any 
medium is indestructible ~ even 
fhe Rosetta Stone was cracked 
when they found tt. But in gen- 
eral, the longer the technology has 
been tried and tested, the more 
reliable it will be. 


Referring to K Dunbar’s 
Mandelbrot program in the 
September QL World, the 
problem is in line 120. This line 
should check theabsolute value 
(abs) of a plus b - then it will 
work. In the listing given, his 
OR code is only checking three 
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out of four quandrants and the 

AND code is only checking one 

out of four. There are other ways 

of approaching this, but this 
would seem to be the simplest. 

Simon Goodwin 

Warley 

West Midlands 


I'm happy to inform you that I 
have received my disk box. It 
arrived some days after I sent 
my letter to you. Thanks a lot. 
Does anyone have any infor- 
mation on Psion Chess—ratings, 
how many positions it analy- 
ses per second, results in 
tournaments it has been play- 
ing, etc? Personally I have 
version 2.01, but I am lacking 
some of this information. [have 
the Atari version of the pro- 
gram. 
Oyvind Vir 
Dorheim 
Norway 


Editor's comment: this is one for 
Emulator users. 


I recently had my 8056 printer 
manual stolen from my car. 
Can anybody supply me with 
a copy of the manual? | will 
pay for copying costs. Please 
contact me via OL World. 
A Landaw 
London NW9 


Those readers who enjoy math- 
ematical recreations might like to 
try out the enclosed program 
which plots the Mandelbrot set. 
Despite the limited palette of 
colours available in high resolu- 
tion mode on the QL, this pro- 
gram gives a quite strikingly at- 
tractive rendering of the set. The 
setitselfis in black; itis the bound- 
ary areas which are coloured. 

A warning —on my Thor 1 the 
complete plotting took some 
24 hours! So those who have 
compilers would be well ad- 
vised to use them. 

Parts of the set can be 
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‘zoomed’ by changing the pa- 
rameters on the real and imagi- 
nary axes. 

The set is fully described by 
A K Dewdney in four articles 
in Scientific American in the 
issues for August 1985, No- 
vember 1987, February 1989 (in- 
cluding the basic algorithm) and 
June 1989. These should be 
available as back issues from Sci- 
entific American, or for reference 
through some public libraries. 

Experimenters can try jug- 
gling with the colours in lines 
210 to 280. 

Values for the set run from -2 to 
5m real (x) axis and from 1.25 to 
1.25 on imaginary (y) axis. To 
zoom on portions of the set, lines 
40, 300, 310 and 320 are to be 
modified by entering the new 
starting points for the real and 
imaginary on line 40 and then 
setting the incrementsin lines 300 
and 310 by dividing the range by 
the horizontal and vertical steps 
(in this case, 380 and 256). 

Line 330 is not strictly neces- 
sary — | put it in to show you 
where you are for determining 
interesting boundary areas of 
the set for later ‘zooming’. 

Frank Gutteridge 
Corsier 
Switzerland 


And last but not least, back to 
Capt. Starling’s letter on the 
Perfection Manual last month. 


Deep in the heart of Mr 
Churchill’s own constituency, 
Freddy Vachha selects a suit- 
able quotation from his wide 
acquaintance with the great 
man’s sayings. “This is some- 
thing up with which I will not 
put,” he says firmly. “Capt. 
Starling asks why we don’t put 
the important bits at the front. 
How much front do we have? 
The reference to justification 
and the differences between 
Perfection and Quill are in Sec- 
tion 1, subsection 1.1, on the 
first page of the manual!” 

And they are, too. It isn’t re- 
ally fair to say that the 
instructions are hidden in a 
page called ‘line setting’ — cen- 
tring and justification is 
line-setting. A decade ago no- 
body would have talked about 
Justification when they meant 
Formatting, but the innocent 
process of Justification (de- 


scribed with great accuracy by 
Freddy in his paragraph on 
pseudo-spaces at the top of 
page 27) has taken a trouncing 
in recent linguistic migrations 
and is now generally used to 
describe any sort of line or 
paragraph formatting - O 
tempora, 0 mores! It isn’t only 
computer terminology which 
confuses people. 

You can indeed use Perfec- 
tion without the aid of a 
manual, but as with any word 
processor you must tread gen- 
tly in places. The HELP screen 
has Justification near the top, 
and everything else on one 
‘page’. Even so, starting life 
with anew word processor by 
attempting to Centre a head- 
line is jumping in at the deep 
end — if you get into trouble it 
can be difficult to intuit your 
way out. In fact, Eric Starling’s 
problem wasn’t with the Justi- 
fication commands, but with 
the Reformatting — something 
which Quill, unlike the vast 
majority of word processors, 
does automatically as you type. 

Most word processors don’t 
do this because it causes dras- 
ticreductionsin speed. Instead, 
they offer a choice of format- 
ting lines and paragraphs to 
order, reformatting entire 
documents before printing to 
enforce the formatting com- 
mands, and the better ones 
(including Perfection) also al- 
low the entire document to be 
configured in advance to follow 
a particular formatting con- 
vention. You don’t have to 
worry about this normally be- 
cause the defaults are set up to 
allow typing and printing of 
justified text. This doesn’t in- 
clude centred headlines, 
though, because not many 
people use them. 

The section on menus is in- 
troduced in section 2.1, and the 
section which describes the in- 
dividual commandsis roughly 
between pages 45 and 83. The 
trouble with putting the im- 
portant things at the top is that 
everyone has different priori- 
ties, and there is never enough 
top to go round. 

My favourite quotation (not, 
I think, from Sir Winston) is: 
“When all else fails, read the 
instructions,” but the prophet 
should have added: “For any- 
thing more complicated than a 
can-opener, allow about an 
hour.” 
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A Question of Dots 


Geoff Wicks scans the desktop publishing field. 


esktop publishing for the QL has 
made great strides in a space of 
a few years from the simplicity of 
the first Front Page to the so- 
phistication of Professional Publisher. With 
the increasing complexity of the programs 
the demands on memory have increased. 
Front Page could be used on an 
unexpanded QL, was about 30 K long and 
and could only fit a half page (40 K) in the 
available memory. Professional Publisher 
is about 200 K long and has a maximum 
page size of almost 375 K. To be able to 
use this page size an 896 K Trump Cardis 
necessary and no more than one page can 
be saved on a 3.5 in disk. | cannot resist 
the temptation to add that less than 10 
years ago we were all struggling to fit 
everything into the 1 K of a ZX81! 
For me there is simple test of the quality 
ofadesktop publishing system. The Work- 
] ers’ Council of which | was formerly secre- 
tary is legally required to produce an an- 
nual report, which must be sent to every 
employee and to various official agencies. 
The report is about 7000 words long and 
became a prestige document in which we 
invested a great deal of effort. It was 
produced traditionally with typewriters or 
wordprocessors, cut and paste and photo- 
copying. The only recent innovation was 
the use of computer fonts for headlining. | 
had used QL desktop publishing programs 
for announcements of council elections 
and meetings, but convincing my council 
colleagues that the annual report could 
also be produced this way was a different 
matter. 


The Full Scope 


At one time | would not even have made 
the attempt, partly on technical and partly 
on aesthetic grounds. | have experience of 
the Front Pageseries, Desk Top Publisher 
Special Edition and Professional Pub- 
lisher, but have never used either text 87 
or Page Designer. Of the programs | have 
used, only Professional Publisher has the 
technical scope to allow the easy import- 
ing of large quantities of justified text to be 
printed in an attractive and easily readable 
font. This was necessary before | could 
convince my layman colleagues that a 
better report could be produced using 
desktop publishing. 

One of the connections between the 
technical possibilities of a desktop pub- 
lishing program and its aesthetics is the 
possible resolution. Commercial 
typesetting systems have a minimum 
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resolution of 600 dots per inch (dpi). A 
laser printer has a resolution of 300 dpi. An 
A4 page in Desk Top Publisher or Pro- 
fessional Publisheris 960 pixels wide — a 
resolution of 120 dpi and 800 pixels long— 
a resolution of 72 dpi. An A4 page pro- 
duced on the Front Pageseries is 800 pixels 
wide, a resolution of 100 dpi. Put another 
way, there is a limit to the quality you can 
produce unless you have far more memory 
than is available to the average QL user. 
The software houses producing the pro- 
grams have to work within this restriction. 

This also explains why the original Front 
Page was the desktop publishing equiva- 
lent of the ZX81. It deserves a place in 
history as the first attempt to provide desk- 
top publishing on the QL, and was the 
starting point for more sophisticated pro- 
grams. It taught the fundamentals of desk- 
top publishing but was not suitable for 
serious work. All text had to be input manu- 
ally in windows that did not cover either the 
full width or full length of a screen, let alone 
a page, and the only fonts that could be 
used were low resolution QL ones. 

QL fonts are produced on a matrix eight 
pixels wide and nine pixels high, although 
in practice since CSIZE 0,0 is only six 
pixels wide two of the columns are not 
used. Effectively the matrix is 6x9. The 
larger CSIZES are magnifications of this 
grid, so thatin practice the maximum reso- 
lution possible for character widths 0, 1, 2, 
and 3, when used in desktop publishing, is 
equivalent to 120 dpi, 120 dpi, 80 dpi and 
60 dpi. The grid is too small for certain 
letters such as m and the w to be repro- 
duced legibly in the smaller CSIZEs. If the 
larger CSIZES 
are used the fa- 
miliar steps in 
the letters can 
be seen. Aes- 
thetically itis not 
pleasing. 

In the early 
days of desktop 
publishing there 
were a number 
of attempts to 
alleviate this. | 
The step effect 
is most notice- 
able in curved 
letters such as 
O or diagonals 
such as Z. 
‘Square’ fonts 
were some- 


The standard GL 
font uses a 6x9 
arid 


times used to keep the number of curves 
and diagonals to a minimum, but although 
they could be used for small quantities of 
text such as announcements, they did not 
look natural in larger documents. Another 
possibility was the fat fonts in which the full 
8x9 grid was used to design the characters 
instead of an 6x9 grid. This gave a slightly 
better resolution than the standard char- 
acters, useful when designing an moraw, 
but the disadvantage was that only CSIZES 
1,0 and 1,1 could be used. Digital Preci- 
sion supply several attractive versions of 
fat fonts with their desktop publishing pro- 
grams and with Lightning. Unfortunately 
many of the fonts are too fancy for text use 
in a serious document. 

The only other possibility of improving 
the quality of documents using a standard 
QL font is at the printing stage. Later 
versions of the Front Page series allowed 
printing with more than one pass of the 
printing head. A better quality printout was 
obtained by a very slight displacement of 
the printing position for the second pass. 
Professional Publisher has amore sophis- 
ticated printer driver which offers an ‘Inter- 
polation’ option in which ‘a suitably com- 
puted pixel row is inserted between any 
two ‘regular’ rows. If you possess Profes- 
sional Publisher the effect can be seen by 
printing out a small amount of text pro- 
duced using the standard QL font in three 
different ways. First — with one printer 
pass, second — with two passes and third 
—with one pass but selecting the interpo- 
late option. 


Improvements 


Front Page Extra was a great improve- 
ment on Front Page. Not only could justi- 
fied text be imported in columns from Quill 
doc files, but also high resolution fonts 
using grids larger than 8x9 were intro- 
duced. The text importing routines were 
fairly simple. The user only had the choice 
ofthe number of columns per page and not 
of the width of the columns. The possibili- 
ties of highlighting text with bold or italic 
characters were very limited, since the 
user had to stop inputting to change the 


A square font also A “fat” Font uses 
uses 2 Ge9 grid 


an 8x3 grid 
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font. Only complete lines could be high- 
lighted and only standard QL fonts could 
be used. Nevertheless within these limi- 
tations the importing of text files worked 
faultlessly. 

The high resolution fonts were few in 
number but were useful for headlines. 
The width of the characters had to be a 
fixed number of bytes. The maximum 
width was 8 bytes arid in theory the fonts 
could be of any height. A grid of 64x64 
was thus possible. No proper font editor 
was provided so that if | wished to change 
a character or devise a new font, | had to 
fall back on a rather complicated proce- 
dure of saving the font as a screen, 
modifying this with Eye-Q, and then re- 
loading itinto Front Page. A further disad- 
vantage was that each character had to 
be of the same width. With the smaller 
fonts it was necessary to choose between 
a width of one byte and have unclear m 
and w, or two bytes and have a large 
white gap on either side of i. The larger 
the font size, the more acute this problem 
of fixed character width became. 

At about the same time, Digital Preci- 
sion released Desk Top Publisher and 
shortly afterwards Desk Top Publisher 
Special Edition. At first sight these seemed 
to offer more facilities than Front Page. 
The range of high resolution fonts was 
much greater and more professional in 
appearance, they could be manipulated 
in various ways to produce italic, bold and 
inverse versions and a variable character 
width was possible. A good font editor 
was supplied as part of the program. 
Unfortunately these fonts also had their 
disadvantages. They were all produced 
on a 16x16 matrix, although a special 
technique for defining the base line posi- 
tion of lower case characters with de- 
scenders (g, j, p, q and y) made this 
equivalent to a 16x24 matrix. The only 
way to obtain a larger character size was 
by the magnification of a smaller font, 
with the inevitable appearance of jagged 
and stepped edges. Another shortcom- 
ing was that the full Ascii keyboard set 
(characters 32 to 127) was not supported. 


Importing 


The text importing routine was also full of 
promise, since not only could the QL char- 
acter set be used, but also high resolution 
fonts. Windows into which text was to be 
inputted could be opened anywhere on 
the page and highlighting took place auto- 
matically. | found however one snag with 
the importing routine. | could never get it 
working satisfactorily unless | resorted to 
inputting paragraph by paragraph. 

In this period | found myself longing for 
the ideal program combining the best of 
Front Page with the best of Desk Top 
Publishing. The next best thing was to use 
a combination of both when designing a 
page. | even devised means of converting 
the high resolution fonts from one program 
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to the other. 
When itcameto 
text inputting, | 
opted for a low 
resolution QL 
font and Front 
Page. | even 
went so far as to 
make a mock- 
up of a few 
pages of my 
annual report 
using one of 
Digital Preci- 
sion’s fat fonts 
and Front 
Page's input 
routine, but the 
result was dis- 
appointing and 
unlikely to con- 
vince the lay- 
man that desk- 
top publishing 
techniques 
gave a better 
result than tra- 


“teeth”. 


the font is not attractive. 


better quality letter. 


Clearly seen. 


The STANDARD QL font is produced on 
a matrix of 6 horizontal and 9 vertical 
dots. When magnified the letters have ree 


A SQUARE font is also produced on a 
6 x 9 matrix. There are less ‘teeth’ but 


A HIGH RESOLUTION font is produced 
on a larger matrix, in this case 16 x 16, 
The improvement in quality can be 
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A “FAT” font is groduced on a 8 x 9 
matrix. The extra width produces a 
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ditional ones. 

When my ideal 
program finally 
arrived in the 
form of Profes- 
sional Publisher 
it surpassed all 
my expecta- 
tions. The high 
resolution fonts 
really were high resolution and could be on 
grid sizes from 8x8 to 48x48. The full Ascii 
range (characters 32 to 191) is supported. 
Furthermore not only did the text importing 
routines work almost perfectly with both 
QL and high resolution fonts, but the text 
could be made to flow from window to 
window, saving valuable time. Occasion- 
ally | have had problems with text empha- 
sis which usually occur when two emphasis 
changes are made at the same time (for 
example, printing bold underlined text). 
However when this has occurred a slight 
change to the text to be input has usually 
been sufficient to set the matter right. 

One of my small criticisms of Profes- 
sional Publisher, although | suspect that 
not everyone would agree with me, is that 
there are too few good high resolution 
fonts provided with the program suitable 
for use with large amounts of text, a situa- 
tion which has been partially remedied by 
the new fonts in Professional Publisher 
Toolkit; Having said this | would however 
warn against having too high an expecta- 
tion of the results of using fonts. In practice 
the maximum font size for use with large 
quantities of text could not be greater than 
a 12x12 matrix, which is better than the 
standard QL font, but no better than the 
resolution of the NLQ mode of a dot matrix 
printer. 

The fact is that the quality of desktop 
publishing on the QL given traditional 
hardware constraints is of fairly low reso- 


Variable width 
letters are better 
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letters are better 


Variable width jetters (top) greotly improve the 
‘arance of a font. Front Page supported 


Alt hit resolution fonts m Desk Top 
Publisher were produced on a 16 x 
matra When magnified they had "steps" 


lution where only standard mdth andlength 
printing is available, 120 dpi compared to 
the 300 dpi of a laser printer and the 600 
dpi of typesetting systems. The only way 
that resolution can be improved is by using 
some form of reduction at the reproduction 
stage. If you want better quality you have 
to produce a page on A3 or A4 and reduce 
it at the printing or photocopying stage to 
A4 or A5. You have then boosted your 
resolution to 180 dpi, and this technique is 
used by many small publishers using tra- 
ditional as well as dtp methods. 

Just imagine, though, the quality you 
could achieve if you could design a page 
the size of a broadsheet newspaper and 
reduce it to A4. Professional Publisher can 
do just that! The printer driver provided 
supports fingerprinting, in other words, 
printing at a quarter of the size of the page. 
It provides a horizontal resolution of 240 
dpi and avertical resolution of 144 dpi. The 
quality has to be seen to be believed. For 
me it is the printer driver that places Pro- 
fessional Publisher in a class of its own, 
and makes it the only QL desktop publish- 
ing program for the very serious user. 

You can guess the rest. | produced a 
mock-up of my annual report and was 
pleased with the results. Only one thing 
stood in the way of convincing my col- 
leagues that we must go over to desktop 
publishing — unfortunately Professional 
Publisher had come too late, and | was no 
longer a member of the Workers’ Council! 
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UPGRADE CHIP 


QL 


ARD.WARE 


LEVEL 2 | 
up grade chip 


For those who have 


early OL memory 
expansions, Rich 
Mellor tests a cheap 
way of upgrading. 


INFORMATION: 

Product: FLP/RAM Level2 replacement 
chip for the Trump Card or 
SuperQBoard 


Price: 


£15 (plus £4 post and packing) 


Supplier: Jochen Merz, Im stillen Winkel 
12, W-4100 Duisburg 11, 
Germany. 


or those of us who cannot afford 

the upgrade to a Gold Card, but 

wish to make the most of their 

existing equipment and get extra 
speed at a low cost, this new chip can bea 
great help. 

Lam the proud owner of quite an early 
Trump Card (although Miracle have been 
kind enough to upgrade the rom on the 
board for me in the past) and having 
decided that I did not (as yet) need the 
extra memory and power provided by the 
Gold Card, this little wonder seemed the 
ideal half-way house. 

What you actually get is a small micro- 


chip in a protective holder and a new 
manual explaining the new features pro- 
vided by it. I] was disappointed to see that 
Jochen did not provide any instructions 
on how to fit the chip (contrary to his 
normal helpfulness), but this did not cause 
me any difficulties in practice, although 
some users may be rather disconcerted by 
this. 


Simple fit 


After switching off the QL and removing 
the Trump Card, fitting the chip was in 
fact quite simple (I do not know if it would 
be more difficult on the SuperQBoard for 
which there is a similar chip available); I 
merely had to lift the cover off the Trump 
Card (I just gently prised off one side — 
there was no real need to undo the fiddly 
screws which hold down the other side of 
the cover) and identify the chip to replace. 
It was not very difficult to spot, because 
(on the old Trump Card) there were only 
two chips of a similar size. The chip which 
has to be replaced is the first chip on the 
left-hand side of the card (looking from 
the edge connector) which lies parallel 
with the left side. You need to use a flat 
bladed screwdriver and a lot of patience to 
prise the chip out of the socket, noting 
which end of the chip has the notch in it 
(this should be the end nearest the edge 
connecter). Once this has been remnoved, 
simply push the new chip home using 
gentle pressure and being careful not to 
bend any of the legs, plug the Trump Card 
into the OL and switch on the power. 


If your OL powers up correctly the F1/ 
F2 screen should display free memory of 
896K (depending on whether you have 
the full Trump Card), Trump Card 2,09 
and Toolkit 22.23 (or higher). If this is not 
shown, then check that the Trump Card is 
correctly inserted before assuming you 
have failed to insert the chip correctly. 

Once this has been done, it will not be 
obvious that the new chip has been in- 
serted until you try to access the disk 
drives or microdrives. Disk access is no- 
ticeably quicker than on the earlier rom, 
but unfortunately it is difficult to give 
accurate speed-up ratios for the new rom, 
because with the new chip installed the 
QL makes greater use of what are known 
as ‘slave blocks’ — areas in memory used 
to speed disk access by storing parts of 
files temporarily, This is most obvious on 
COPY and SAVE operations where your 
program can continue working well be- 
fore the end of the SAVE operation. The 
example below shows the difference that 
this can make (although the overall saving 
is minor). [t does however mean that 
programs are improved two-fold. 


Loading speed 


Programs like the Psion package which 
only load part of a long file at a time are 
speeded up somewhat because more of 
the file is actually held in the slave blocks, 
therefore the program does not have to 
access the disk quite so often. On a test file 
on Quill, this speeded up downward 
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scrolling by 20 per cent, and upward 
scrolling by 10 per cent. 

Control is returned to the user more 
quickly, allowing you to continue typing 
in Perfection (for example) much sooner. 

Speed of file access is not all that the new 
chip can offer. With the new chip installed, 
you now have similar facilities as on the 
Gold Card for real sub-directories and 
better file handling. 


Directories 


The new manual which you will receive 
with the chip gives details of how to use 
the new commands to create sub- 
directories on disks, hard disks or ramdisks 
(you cannot currently create sub- 
directories on microdrives, but then you 
should not have that many files on a 
microdrive); together with how to set up 
your expansion board for your disk drives, 
and there is even a little section giving 
some information about ramdisks. 

The first group of commands in the four 
page manual is the most important, 
because these allow you to set up your 
system to take account of the type of disk 
drives attached: the command 


FLP_START and FLP_STEP allow you to 
set the start-up time for your disks and the 
step-rate respectively (only the latter 
command will be new to Trump Card 
users). The step-rate should be set to the 
rate suggested by the disk drive 
manufacturer (if you have any instructions 


for your disk drives) — I purchased my 
one-third height drives from Miracle in 
1986/7 and have found that the highest 
step-rate (3) was necessary to prevent the 
disk drives from groaning every time that 
they are accessed. 


Security level 


The old Trump Card command 
(FLP_SEC) which allowed you to alter the 
amount of checking out when a file is 
saved ora disk formatted no longer works 
with this new chip — instead the highest 
security level is always chosen 
automatically. 

Other new commands allow you to set/ 
read the update date, the backup date 
and/or the version number of the given 
file. The update date is the date and time 
when the file was last altered (forexample, 
saved or copied to). In contrast, the backup 
date is generally used to contain the date 
and time when the file was last copied 
from (this will however be zero unless it is 
set using the command SET_FBKDT). I 
would have liked to have seen 
amendments to the COPY and WCOPY 
commands so that the backup date of the 
file being copied was set to the current 
system date and the new file retained the 
same update date as the original (of course 
the backup date of the new file would 
have to remain zero as now, because this 
has not been copied from). 
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The version number of a file can be use- 
ful if you are developing a program, so 
that you can keep track of which version 
ofa file is which. Unfortunately, each time 
that you save a file, the version number is 
reset to one — maybe the SAVE function 
should be altered so if a file already exists 
it asks if you (a) want to overwrite the file 
and (b) update the version number. So far 
as I have been able to ascertain, unless you 
use the given command (SET_FVERS) to 
alter the version number by hand, the only 
command which will automatically 
increment the version number is OPEN 
which updates the version number (unless 
you tell it otherwise by issuing the 
command SET FVERS #channel before 
closing #channel) when the file is later 
closed. 


Sub directories 


The final utility provided by the new 
chip is the ability to have real sub- 
directories. These are really only of any 
use to users who have access toa hard disk 
and will no doubt override the rather poor 
implementations of sub-directories which 
exist on some of the QL hard disk systems 
(of course they are a big help for the extras 
high density disk drives, but then you 
need a Gold Card to access those anyway!). 

The original Trump Card romand Toolkit 
ll provided several commands to move 
up and down a ‘directory tree’, including 
DUP, DDOWN, DNEXT, PROG_USE..., 
but these were a little difficult to use and 
did not help to put the files ona given disk 
into any sort of order. To complement 
these commands, the new chip introduces 
two new commands MAKE DIR and 
FMAKE DIR which both perform the 
same job, but the lattercommandis actually 
a function and enables you to trap any 
error codes easily. 


New commands 


The new commands allow you actually 
to ‘place’ different files into a separate 
sub-directory. Forinstance, yourdisk may 
contain the following files: 

boot 

quill 

program1_source_bas 

program1_manual_doc 

program]_source_asm 
program2_source_bas 
program2_source_asm 

Entering the command MAKE DIR 
flp1_program1_ will then group all of the 
files together which begin with the prefix 
‘program_’, altering the display of DIR 
flp1_to: 

boot 

quill 

program2_source_bas 

program2_source_asm 

program] -> 


UPGRADE CHIP 


As you can see this is a very useful way 
of ordering your disks whether they be 
floppy disks or hard disks. What is even 
more unusual is that any attempt to delete 
the file program] (which forms the sub- 
directory) gives the error ‘in use’ if there 
areany files contained in that sub-directory 
and any attempt to rename the file pro- 
gram] gives the error read only (whether 
there are any files there or not — contrary 
to the manuall!). 


Forced default 


Entering the command DIR 
flp1_program1 will only list those files 
contained in that sub-directory. You can 
force the QL to accept the given sub- 
directory as the current default by using 
the standard Toolkit II command 
PROG_USE, after which DIR alone will 
list all files contained in that sub-directory. 
Unfortunately this is not as helpful as it 
may seem, because some programs refuse 
to recognise the Toolkit II default 
directories (eg FLP_USE flp1_program1), 
so that whenever a program tried to access 
FLP1_, they would in fact be accessing the 
sub-directory FLP1_program1_. 

Putting the failings of some software 
aside, this little chip is a major 
improvement for all the old Trump Card 
and SuperQBoard users, and the price is 
low enough to entice the less well-off to 
upgrade their expansion board. The speed 
of accessing files is noticeably smoother 
and I can well believe the advertised claims 
that this device driver is twice as quick as 
the original. If you cannot afford a Gold 
Card, then this may well be the next best 
thing. 


For the means of testing the new chip, 
I created a test document on Quill of 
11788 words (35 pages long). The 
document was then tested ona Minerva 
QL (1,92) with TurboQuill+ (2.35) and 
Lightning SE (2.11). 

Test run 2 was with the new chip 
installed. 
1) Load document into Quill 
2) Scroll down through document 
3) Scroll up through document 
4) Go from top to page 22 

TEST 1 TEST 2 

43.10 secs 16.54 secs 
5 mins 35 secs 


6 mins 54 secs 
14 mins 49 secs 3 mins 23 secs 


3.44 secs 3.05 secs 
The overall average speedup on Quill 
itself was therefore some 14 per cent. 

Similar speedups in relation to 
loading the document were 
experienced with regard to Perfection 
{the document, after converting to 
Perfection format, loaded some 51 per 
cent more quickly), although scrolling 
on Perfection is mainly unaffected due 
to the way in which Perfection works. 


New Uses For 


ABACH 


ike many OL owners | suppose I[ 
routinely use Quill more than any 
other member of the Psion four, 
but am always especially pleased 
when an opportunity to use Abacus comes 
along. As time goes on I find more and 
more uses for this very versatile program, 
although I don’t go as far as the proverbial 
executives who regularly use their 
spreadsheets for word processing! 

Ihave used Abacus for keeping the marks 
list for my classes, printing voting slips for 
a political meeting, printing planting in- 
structions for bulbs, making up lab sheets, 
and, in conjunction with Easel, for calcu- 
lating and plotting graphs of scientific 
functions. Yes, [know some of these sound 
suspiciously like word processing, but I 
can defend myself — in due course! 


Several answers 


To begin at the beginning, what exactly 
is a spreadsheet? There could be several 
answers to that question depending upon 
theuser. Toanaccountantitis an electronic 
balance sheet — and this is where articles 
on Abacus in Sinclair QL World have gen- 
erally stopped — but to a scientist it is a 
powerful calculation tool, to a teacher it is 
an electronic register and under special 
circumstances it can be better than Quillas 
a word processor. I should like to argue 
thatat heartitisa programming language, 
a sophisticated editor and a memory 
monitor all rolled into one, and this is 
what makes it so useful in so many fields. 
Since most readers of OL World will be 
familiar with Basic, at least tosome degree, 
let's compare the Abacus programming 
language with Basic, by means of a rudi- 
mentary spreadsheet in SuperBasic (see 
listing one). 

If you type this in and runit you will find 
that it prints a3 x 3 grid and does a couple 
of calculations in the manner of Abacus. 
The procedure 'Set_up' opensa set of small 
screen channels whose windows form the 
grid. The main program (lines 120 to 200) 
consists of a series of similar lines each 
containing two statements: the first defines 
a variable and the second displays its 
current value in anexclusive small window 
(or grid cell). You can edit the first state- 
ments to change the definitions, but any 
other changes destroy the structure of the 
program. Note that] have chosen variable 
names to correspond to the cell references, 


PART ONE 


Howard Clase believes that there is more to a 
spreadsheet than simply spreadsheeting. 


and the program executes the statements 
across the grid in the same order as you 
are reading this ~ from left to right across 
each row starting at the top and working 
down row by row. The definition may 
include the value of another variable but 
this obviously must have been defined 
earlier in the program - although, since 
RUN in SuperBasic does not CLEAR the 
variables, a couple of RUNs may, in fact, 
get everything right. 

Abacus works in exactly the same way as 
my Basic program, but has many more 
sophisticated features. Since the program 
lines, variable names and cell positions 
are unalterably linked to each other, two 
of themare redundant: itis quite sufficient 
to use the cell position for all three, and 
that is what Abacus does. Executing 
Abacus (<F3>, <X>) is equivalent to RUN 
in SuperBasic, and it normally executes 
‘by rows’, ie from left to right across each 
row from top to bottom of the grid 
(although there is the option to do it ‘by 
columns' instead). Unlike Basic, however, 


Listing one 


100 nm$ = “Abaemu bas” 
119 CLS: 
120 al 
130 bl 
149 cl 
150 a2g="": 
160 b2eg="Sum = °: 
170 @2 = altbitels 
180 a3g="": 
190 b3$="Product = ": 
200 c3 saltbi¥ecl 

210 STOP 

220 REMark *“***"~* 

230 DEFine PROCedure 
240 LOCal c.i.g.m.x,¥: 
250 FOR j=1 TO m 

260 FOR i=1 TO m 

27 a= m*(j-1)+i: OPEN#c,con 

260 x=128+64¥(i-1): yod2ti2e(j+l) 
230 WINDOWHc,64,12,x,¥ 

300 BORDER#c,1.4,0: 


MODE 4: Set_up 
2: PRINT#1,al 
PRINT#2,b1 
PRINT#3, 
PRINT#4,< 
PRINT#5. b2 
PRINT#6,¢ 
PRINT#?7. 
PRINT#B, 
PRINT#9,¢ 


m=3 


CLS#ec: INK#c,6 
310 END FOR i: END FOR j: END aia 


there is no facility for jumping or looping; 
the structure is much more rigid and every 
cell is always evaluated — but there are 
ways around this; there is at least an IF 
function, but more of that later. 


Emulator 


The first problem with my little emula- 
tor is that in order to alter anything you 
have to use the QL's line editor. Note that 
you also have to be careful to add the $ 
sign to the variable name if you want it to 
contain text rather than numbers. With 
Abacus you use the arrow keys to move 
the cursor to the cell of interest and you are 
right in the editor; all you have to do is to 
type in or alter your definition. But you 
will still have to tell Abacus the 'type' of 
your entry if you want it to be text by 
typing in the double-quote character. A | 
number of my correspondents have com- 
plained about this — saying that Abacus 
ought to be able to tell, but this is because 
they are not aware of the full potential of 
the program. 

The problem is the availability of ‘labels’ 
for rows and columns, which enable a cell 
to be designated by a reference like ‘July. 
Costs' as well as the grid reference eg C6. 

If the program assumed that any word it 
did not recognise as a key-word must be 
text then you would not be able to use 
labels; it's the usual compromise. (That 
said, I personally, do not find labels par- 
ticularly useful, and rarely use them my- 
self; even if you do the program immedi- 
ately converts them to the standard grid 
reference format anyway! The one use | 
have found for labels is for finding a piece 
of text in a large spreadsheet, eg a stu- 
dent's name ina register, if you press <F5> 
and then enter the text the cursor goes to 
the end of the first row containing the 
text.) Putting in the quotes is equivalent to 
having to puta $at the end of the name of 
a string variable in SuperBasic. While you 
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should start with double quotes ("), Aba- 
cus will automatically supply the closing 
quotes. But if you are like me and often 
forget the initial quotes, all is not lost: you 
can put them in yourself — but now you 
must put both in, before and after (and 
you can use either single or double quotes 
as long as they match). You can convert a 
value or formula to 'text' too if you like by 
using the AMEND command <F3>, <A>; 
this is sometimes useful while building a 
spreadsheet, acting like a REM in Basic. 


Double quote 


If you do not start with the double quote 
Abacus assumes you are entering a nu- 
merical value or a formula. Typing a 
number assigns its value to that cell like a 
LET in Basic, while, if you want to put ina 
formula you have almost as large a range 
of functions available as in Basic. These 
can be combined into quite long expres- 
sions, the limit is about 160 characters. Just 
as in SuperBasic any formula typed in is 
checked for syntax before Abacus will 
accept it; the error message [ get most 
oftenis undefined name reference’, which 
in practice means that | have spelled 
something incorrectly! 

Tf you are building up a large Abacus 
program itis a good idea to go into Design 
(<F3>, <D>) and press <A> to switch off 
the auto calculation. This stops it from 
running through the program every time 
you make an entry or alteration. If you 
need to test, then <F3>, <X> will do it for 
you when you need it. 

To alter an existing definition then type 
<F3>, <A> this puts you directly into the 
Psion line editor which has more facilities 
than the one available when you are writ- 
ing SuperBasic — <SHIFT+arrow> moves 
the cursor a word at a_ time, 
<SHIFT+CTRL+arrow> deletes whole 
words, and <CTRL + up/down-arrow> 
deletes from the cursor to the beginning / 
end of the line respectively. You will prob- 
ably have become familiar with these ex- 
tra facilities since they are also available in 
Quill. 

Abacus acts like a software monitor in 
that it always displays the current ‘value’ 
ofeachcellinthe grid, just like the monitors 
that machine code programmers use to 
examine the value of each byte of memory. 
In Basic terms there isan automatic PRINT 
statement in each cell. It is this current 
value as displayed on the screen that the 
program uses in its calculations when a 
cross reference is made, and not the for- 
mula, and it is the set of current values that 
make up the display that you will normally 
print out. 

The equivalent of LISTing your Abacus 
program is definitely not as easy as with 
SuperBasic. 

On screen the simplest way is to move 
the cursor through the grid cell by celland 
see the contents of each cell printed at the 
bottom of the screen, but there is a prob- 
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lem, there is only room to display a single 
line (about 70 characters if you use a moni- 
tor, fewer in tv mode). So if you have 
entered a long formula you may not see it 
all. Fortunately, you can recover it all by 
using the AMEND command - <F3>,<A> 
—, which displays two whole lines of the 
contents of the current cell in the editing 
area of the screen. This may seem cumber- 
some, and you have to be in monitor mode 
to get all 160 characters, but it is the best 
available. 

Getting a hard copy listing of your 
Abacus program is even more inconven- 
ient. First, long formulae are not catered 
for; only one line is printed, truncated at 
60 characters. (If anyone finds a way 
around this please let me know and I'll 
pass it on.) Second, the actual presentation 
of the formula is different from that which 
you have typed in or which appears on 
screen, This is a by-product of the relative 
addressing which is otherwise a strength 
of Abacus. If you refer to cell Al while the 
cursor is on B3, and then COPY or ECHO 
the formula (<F3>, <C>/<E>) to, say, D4 
you will find it now refers to C2 instead of 
Al. Abacus reads the reference as ‘one 
column to the left and two rows up' rather 
than as an absolute reference to cell Al, 
and this is the way the reference is printed 
out ~in this example as C|-1]R[-2]. This is 
because Abacus refers to a ‘master’ for- 
mula rather than a separate copy for each 
cell that uses the formula. If you select the 
formula option on printing then you will 
get a map of the grid with the location of 
each formula identified by a code number, 
eg F12, followed by a list of the formulae 
or the first 60 characters of them at any 
rate. (In the manualit says that the formulae 
come first, but my versions of Abacus all 
do it the other way round.) 


Avoid clutter 


Of course you can always write your 
programs with formulae shorter than 60 
characters, but this may clutter up the 
screen with unnecessary intermediate val- 
ues, 

In the Abacus programs that follow I 
have printed the contents of a typical screen 
followed by a listing of the key formulaeas 
you would type them in, Any errors should 
beattributed to my typing and not blamed 
on OL World's typesetters. All other cells 
contain either text or numerical values as 
seen on the screen. 

But rather than continue in the abstract, 
let's look at a few actual examples of the 
sort of programs lam talking about. These 
are intended to introduce readers to some 
of the functions in Abacus that you may 
not meetin ordinary financial spreadsheet 
programming, and are examples rather 
than really useful programs in their own 
right. 

Many numerical problemsin science and 
maths can be reduced to feeding numbers 
into a standard formula —sometimes after 


a bit of algebraic massaging. Of course 
Abacus won't do the algebra for you, but 
it will do the calculation for you more 
reliably than your fingers on a calculator. 
Why use Abacus when you can write a 
SuperBasic program to do it? Because it is 
much simpler to set up Abacus to do this 
sort of thing since it is specifically de- 
signed to do calculations, and it is espe- 
cially worthwhile if you want to do re- 
peated calculations of the same type or to 
compare the results of several similar cal- 
culations. There is also the bonus of dou- 
ble-precision arithmetic; Abacus displays 
upto 14 digits against SuperBasic's7, Don't 
be fooled though, the calculation is only as 
accurate as the measurements that are put 
in, and very few measurements are sig- 
nificant to 7 digits let alone 14! 


Log rolling 


There are far more mathematical func- 
tions available in Abacus than the average 
accountant ever finds use for, and even if 
they are fewer than those in SuperBasic 
they are carefully chosen so that the 
missing ones can be duplicated by combi- 
nations. For example, decadic logarithms 
are obtainable from the natural ones by 
LOG10(x) = LN (x)/LN(10). It is a pity that 
more attention wasn't given to consist- 
ency between programs — I always forget 
that the square root function is SOR(x) in 
Abacus and not SORT(x) as in SuperBasic, 
you use CHR(Q and not CHR$() to convert 
Ascii codes to characters, and to 
concatenate strings in Abacus you must 
use+and not &, Also to give permission to 
overwrite a file when saving you must 
press <ENTER> and not <Y> as in Quill. 

Asa typical example I've been delving in 
my old school maths notes and found a 
formula for calculating the area ofa triangle 
from the lengths of the three sides, As well 
as showing how to tackle this type of 
problem it illustrates the use of a couple of 
less familiar Abacus functions — 'ASKN' 
and 'TF’. 

First look at the SuperBasic version of the 
program (Listing two). The three values 
are INPUT (150), and the value of the 
semiperimeter (s) calculated from them 
(160). This must be longer than any of the 
sides or they will not meet to form a tri- 
angle; line 170 tests this and only EXITs 
the loop if all is OK, otherwise there is an 
error message and a raspberry (180-190), 
and you go round again. (NB The value of 
the semiperimeter, s, is not printed on the 
screen.) Once you have got out of the loop 
the result is calculated and printed at line 
210 (there is no need to assign the value to 
a variable before you print it). 

Listing three shows an Abacus version 
of this program following the SuperBasic 
as closely as possible. The top of the listing 
shows the appearance of the screen after a 
typical run. The bottom half shows the 
contents of the cell as you would type 
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them in or as they appear in the command 
area when you move the cursor to the cell. 

The function REPT (<character>,num) 
is like FILLS in SuperBasic: it prints the 
character num times, in this example it is 
used to pretty up the screen. Since there is 
a blank character between each cell you 
must use width ( }+1 to get a continuous 
line without any gaps. The various mes- 
sages are just straight text — itis useful to 
know that if your text is longer than the 
width of the cell it will run over into cells 
totherightas long as they aretruly empty, 
so you don't have to break up the message 
cell by cell here. 


Semiperimeter 


ASKN is the Abacus equivalent to 
SuperBasic's INPUT, and must be used in 
association with execution of the program 
(<F3>, <X> — like RUN in SuperBasic). 
Once the three values are entered the 
value of the semiperimeter is calculated 
in C14, but because of the rigid structure 
of Abacus it has to be displayed whether 
you need to see it or not. 

The next part of the program is different 
from the Basic one since there are no loops 
in Abacus. Fortunately there is an 'IF’ 
statement available, albeit with a rather 
different syntax. Where in Basic we have: 


IF <condition> THEN <actionl> ELSE 
<action2> 


in Abacus this becomes: 
IF (<condition>, <valuel>, <value2>) 


that is, the cell contains valuel if the con- 
dition is true and value? if it is false. In 
Abacus the result must always be a value 
(numeric or text), while in Basic a wider 
range of actions is possible. 

The same inverted test is made in cell 
C15 as in line 170 of the SuperBasic ver- 
sion, but the result is that the text ‘Error’ 
appears if the sides do not meet and the 
empty string if they do, It has to be back- 
wards since the Boolean function NOT is 
notavailablein Abacus. Fortunately AND 
and OR do work in the condition state- 
ment, despite not being mentioned in the 
manual, 

The result of the test in C15 is used in 
cells B16 and C16. The explanation of the 
error is split between the two cells and 
only appears if there is an error. If there 
has been no error the final result appears 
in cell C17, otherwise Abacus will baulk 
at finding the square root of a negative 
number and give its own rather unhelp- 
ful error message. 

A program like this could be set up for 
users uninitiated into the mysteries of 
Abacus. However, I find ASKN rather 
confusing in operation: the question ap- 
pears at the bottom of the grid in the 
command line, and the value of the entry 
does not appear in the appropriate cell 
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[Listing two 


90 nm$ = “Trgl bas” 
100 
1106 
120 
130 
135 
140 
150 
160 
170 
180 
190 
200 
210 


REMark 


REMark 

CLS 

REPeat loop 
PRINT 
INPUT a,b,c 
s=(atbtc)/2 
IF NOT(s<a OR s<b OR sxc): 
PRINT ‘Error - 
BEEP 2500, 25 

END REPeat loop 


a ed 
TOR OM K OOM AD OW NE 


B4: 
C10 
Cll 


Listing three 


<<<< 0 «6Trgl aba »>>>> 

B t c 
**k The area of a TRIANGLE ¥** 
from the lengths of the sides. 


>>> Press <F3>,<K>, and enter the 
lengths of the sides as requested 
at the bottom left of the screen. 


side a 
side b 
side c 


semiperimeter, 


Key Formulae 


rept("*",width()+1) Echoed to C4,B8,C8 


C12: 
C14: 
Gids 


B16: 
G16: 


ig Be 


askn(">>>>> SIDE a ") 

askn(">>>>> SIDE b ") 

askn("“>>>>> SIDE c ") 
sium(C10:012)/2 

i1f(C14<C10 or C14<Ciil or C14<C12, 
corr ae ae 

if(C15="“Error",°* Sides do not f".rept 
("=" width()+1)) 

if (C15="Error","“orm a triangle. 
t("=" ,width(}4+1)) 
sqr(C14¥*(C14-C10)*(C14-C11)*(C14-C12)) 


“Err 


x" rep 


All other cells contain text as seen above. 


HHP WMH CO DInAmTDbwNe 


feeb fae fk fk feck pe ek pe 


Ay 


Listing four 
_ <<<<e Trgl_alt >>>> 


B } CG 
¥* The area of a TRIANGLE ** 
from the lengths of the sides. 


Ku Move the cursor to 
appropriate cell (C10 - €12) 
enter the length of the side. 


ee AE ON AA 


side 
Side 
side 


semiperimeter, 5 

Error 
* Gides do not form a triangle. 
Area = ##ARG 


To calculate the area of a triangle 
kHMark from the lengths of the three sides. 
hjc 1991.06.25 ver 1 


AAA RA 


*Side a’,’Side b’,’Side oc’ 


EXIT loop 
sides do not meet’ 


PRINT \\’Area =’ !SQRT(s*(s-a)*(s—-b)*(s-c)) 


a 


| 


until all three have 
beenentered,so you 
haveno way of spot- 
ting a mistake until 
itis too late. For this 
reason I prefer the 
alternative version 
shown as ‘Trgl alt’, 
Allthe formulae are 
the same except that 
the ASKN functions 
in cells C10:C12 
have been removed 
allowing, direct en- 
try of the lengths of 
the sides. You 
should also turn off 
the AUTO-CALCU- 
LATE — function 
(<F3>, <D>, <A>, 
<ENTER>); this 
causes each value to 
appear as soon as it 
is entered; then 
when they are satis- 
factory press <F3>, 
<X> to execute the 
program. The val- 
ues in this example 
have been chosen to 
illustrate the result 
of an error. 

If you want to 
compare the results 
of several similar 
calculations side by 
side nothing could 
be easier, just COPY 
(<F3>, <C>, range) 
the working part 
(C10:C17 in our ex- 
ample) of the pro- 
gram tothe adjacent 
column or columns. 
If the formulae con- 
tain absolute ad- 
dresses you may 
have a_ bit of 
AMENDing to do - 
see listing four. 

In the next article 
we'll look at some 
more examples. 
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USERGUIDE 


SECTION 


ELEVEN 


W 


KEYWORD INDEX 


ce This month in the Keyword Index, Mike Lloyd moves from 
BEEP to CLOSE in SuperBasic, skirting Super Toolkit 2 and 
Turbo Toolkit on the way. 


BEEP (duration, pitch, pitch2, 
grad1, grad2, wrap, fuzzy, random) 


duration (0 to 32767) 
pitch1 (0 to 255) 

pitch2 (0 to 255) 

grad (-32768 to 32767) 
grad2 (-8 to 7) 

wrap (0 to 15) 

fuzzy (0 - 15) 

random (0 - 15) 


SOUND COMMAND 

the length of the sound. 1 = 72 microseconds 
the first note pitch 

the alternate note pitch 

time interval between gradient steps 

pitch difference between steps 

number of gradient repetitions 

distorts pure tone 

random element affecting all parameters 


The BEEP command can cause more hair-loss than almost anything else associated with the QL. 
Bearing in mind that the QL was supposed to be a business machine, its sound capabilities are 
we surprisingly oriented towards arcade games. It is impossible to play a simple tune without a great deal 
of effort because the pitch values are not related to musical tones and semitones. However, if the 
sound of a rampaging, homicidal alien is required, the QL can quickly come up with suitable 


suggestions. 


Without any parameters, the BEEP command performs the valuable function of stopping any noise 
currently in progress. The minimum parameters acceptable are a duration and a pitch. A one second 
note (of indeterminate pitch) is produced by the command BEEP 720, 8. Note that a permanent note 
is obtained by giving a duration of 0, which also has the unfortunate effect of changing the pitch of the 
note. Ifa second pitch is given you must also give the speed with which the QL will ‘bounce’ between 
the two notes and the pitch difference between each tone in the gradient. Wrap, fuzzy and random are 
further, optional parameters which distort the sound in ways best listened to rather than described. 


Sinclair/QL World January 1992 


Second gradient parameter 
First gradent parameter 


| First Pitch 


THE BEEP COMMAND PARAMETERS TIME... 


BEEPING ( ) 


BGET “chan \offset, 
byte1, byte2... 


[SUPER TOOLKIT 2] 


BIN$ (decval, bits) 


(SUPER TOOLKIT 2] 


BIN (string$) 


[SUPER TOOLKIT 2] 


BLOCK ‘chan, width, 


height, xpos, ypos, ink 


BORDER *chan, 
width, paper 


SOUND FUNCTION 
(No parameters — brackets are optional) & 
The BEEPING function returns True if the QL’s sound chip is working and False if it is not. You may 
not assign these values to a variable (BEEPING will return a 0 if you try) so BEEPING is restricted to 
IF and SELECT statements. Purists will want to put brackets at the end of the function, but those less 
fussy can get by without them. 


LOW LEVEL CHANNEL ACCESS 


*chan a valid channel number, usually a file 

offset an optional value denoting where in the file to begin reading data 
expressed as a number of bytes from the beginning of the file. 

bytexX a value between 0 and 255. 


BGET (B stands for Byte) reads bytes from a channel normally associated with a file. BGET assumes 
that the file is simply one long string of bytes. The following command will read the Ascii values stored 
between character positions 20 and 22: 

BGET #3 \20, A, B, C 


Whether the results are of value depends upon the structure of the file being read. 


BASE CONVERSION FUNCTION € 
decval an integer value 
bits the number of binary digits to produce 


BIN$ takes a decimal value and converts it into a string of 1s and Os which represent its binary value. 
To see directly the result of a binary AND, use the following commands: 


PRINT BIN$ (137, 8) 
PRINT BINS$ (89, 8) 
PRINT BIN$ (137 && 89, 8) 


BASE CONVERSION FUNCTION 
STRING$ any string of characters, but normally made up of 1s and Os. 
BIN converts any string of characters into a decimal number by assuming that characters with even 
Ascii values represent 0 and those with odd Ascii values represent 1. Conveniently, the Ascii values 
of 0 and 1 are even and odd respectively. 


PIXEL-BASED GRAPHICS COMMAND 
‘chan A screen channel 
width The width of the block 
height The height of the block € 
xpos The lateral co-ordinate of the block's top left corner 
ypos The vertical co-ordinate of the block’s top left corner 
ink The colour of the block (0 - 255) 


BLOCK is unique in that it is the only graphics command to make use of the pixel co-ordinate system 
starting at the top left corner of each window. Because it does not need to translate between arbitrary 
floating point graphics co-ordinates and pixel positions it is significantly faster than any other graphics 
command. Use it to draw vertical and horizontal lines in preference to the conventional LINE 
command. If OVER is set to -1 a BLOCK of a suitable colour covering the whole window will recolour 
the window very much faster than RECOL can manage, but with less control over the colours achieved. 
Unlike conventional graphics commands, BLOCK causes errors if you place any part of the block 
outside the window. . } 


GRAPHICS COMMAND 
‘chan (optional) A screen channel 
width The width of the border in pixels 
paper (optional) The colour of the border (0 - 255) 


Every window can have a border around it, reducing the room available to the active screen, The 
border's width remains constant whether a screen is displayed in high or low resolution. If no ‘paper’ 
value is given the border is transparent, therefore a multi-coloured border can be obtained by 
specifying the innermost colour first and ending with a wide, transparent border to protect the colours, 
as in: 
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BPUT *chan, byte, 
byte,... 


CALL address, 
data1, data2... 
data 13 


CDEC$ (value, 


width, decplaces) 
(SUPER TOOLKIT 2] 


CHANNEL _ ID 


(*chan) 
[TURBO TOOLKIT) 


CHARGE 
(task name) 
[TURBO TOOLKIT] 


BORDER 8, 5 
BORDER 6, 3 
BORDER 4, 1 
BORDER 8 


[SUPER TOOLKIT 2] 
LOW LEVEL CHANNEL ACCESS 
‘chan a valid channel number, usually a file or the printer 
offset an optional value denoting where in the file to begin reading data 
expressed as a number of bytes from the beginning of the file. 
byte a value between 0 and 255. 


Information is passed to and from QL devices, such as the screen, printer and files, one byte at atime. 
When you think that you are printing the word HELLO on your screen the computer is actually 
transmitting 72, 69, 76, 76 and 79 to the channel associated with the default window. These figures 
are the Ascii equivalent of the characters HELLO. The command BPUT 72, 69, 76, 76, 79 is the low- 
level equivalent of typing PRINT “HELLO”. The command is of more value when storing values in a 
file or selecting printer settings. Setting a five-character-wide left margin on an Epson printer can be 
achieved by either of the following commands: 


PRINT *5, CHR$(27); “I"; CHR$(5): REM 28 significant keypresses 
BPUT *5, 27, 108, 5: REM 15 significant keypresses 


MACHINE CODE PROGRAM COMMAND 
address A valid, even-numbered memory location. 
dataX (optional) Four-byte integer values. 
CALL is used to initiate a machine-code program previously loaded into a reserved part of the QL’s 
memory with a RESPR command and an LBYTES command. The data parameters are loaded into 
the cpu addresses D1 to D7 and A0 to A5 prior to the program beginning. 


DECIMAL NUMBER FORMATTING COMMAND 


value An integer value 
width The total number of character positions to return 
decplaces The number of decimal places to display 


CDEC$ is an extremely useful way of circumventing the QL's habit of placing numbers with relatively 
few significant digits into exponential format. As a bonus it even provides fixed length strings and 
separates thousands with commas for attractive, justified columns of figures. Although CDEC$ output 
can include decimal places, only the integer part of the input value is recognised. This means that you 
must think of £34.25 as 3,425 pennies. The results can be observed with this snippet: 


100 REPeat loop 

110 pennies = RND (999) * RND (999) 
110 PRINT “£"; CDEC$ (pennies, 8, 2) 
120 END REPeat loop 


CHANNEL FUNCTION 

chan An open SuperBasic channel number 

SuperBasic and Qdos do not agree over what a particular channel is called. This is so that the QL can 
support multi-tasking: one program might have Channel *3 linked to a printer at exactly the same time 
that another program has Channel *3 linked to a screen window. Qdos must be able to service all 
channel requests and so gives each channel a unique number normally invisible to programmers. 
Turbo Toolkit provides this simple function to return the Qdos channel number for any given 
SuperBasic channel. 


COMPILER DIRECTIVE 
filename (optional) A valid taskname 
CHARGE launches a Digital Precision compiler (which one depends upon your default setup). If a 
taskname is included it is used as the name of the task being compiled. 
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CHAR _ INC *chan, 
X_ inc, Y_ ine 
[SUPER TOOLKIT 2] 


CHAR_USE ‘chan, 
font1, font2 


[SUPER TOOLKIT 2] 


CHR$ (ASCII code) 


CIRCLE *chan, xpos, ypos, 


radius, distort, angl, [xpos, ypos, 
etc] 


CIRCLE “chan, Xpos, ypos, 


radius, distort, angl, [xpos, ypos, 
etc] 


CL CHIP 


CLEAR 


CHARACTER COMMAND 
“chan (optional) A screen channel 
X_inc lateral spacing of characters in pixels 
Y_inc vertical spacing of characters in pixels 


SuperBasic offers very limited options for sizing and spacing characters: many of these restrictions 
are removed by Super Toolkit 2. Should you want characters printed at 14 pixel intervals on lines 15 
pixels apart, issue the command CHAR_INC 14, 15. 


CHARACTER COMMAND 
*chan (optional) A screen channel 
font1 the start address of the first font 
font2 (optional) the start address of the second font 


Qdos divides the full character set into two fonts. Super Toolkit 2 allows you to specify different fonts 
in each of the screen windows should you wish. Each font is loaded into ram at reserved addresses 
and the CHAR_USE command is issued to make Qdos aware that the new font is to be used by a 
specified window. Should you accidentally provide an inaccurate address, all characters will be 
replaced by garbage. To reset the fonts to their default designs held in the QL's rom, simply issue the 
command CHAR_USE 0, 0. 


CHARACTER COMMAND 

ASCIl_code An integer between 0 and 255 

The Ascii code assigns specific characters to the values 0 to 127, leaving the values 128 to 255 for 
individual system designers to assign. Thus, every component of a computer's character set can be 
represented by single byte. The first 32 Ascii codes are non-printable codes representing such 
functions as backspace, newline and tab. CHR$ is a function which takes a one-byte value (ie an 
integer between 0 and 255) and produces the character which that number represents. Be careful with 
the values 0 to 31 because they may produce unexpected results. Minerva owners, however, can 
obtain printable characters from these values. Super Toolkit 2 owners will prefer to use BPUT to CHR$ 
wherever possible. 


GRAPHICS COMMAND 
*chan (optional) channel number 
Xpos, ypos co-ordinates of circle centre 
radius radius of circle in graphics units 
distort (optional) ratio between major and minor axes of an ellipse (0 to 1) 
angle (optional) orientation of major axis in radians (0 = vertical) 


CIRCLE uses absolute co-ordinates; CIRCLE-R uses relative co-ordinates. CIRCLE draws circles 
and ellipses on the screen in the current INK colour using the graphics co-ordinates system. IF FILL 
1 is in effect the circles will be solid. A bug causes ‘colour leaks’ if FILL 1 is not issued between 
successive CIRCLE commands. By separating sets of parameters by semi-colons a single CIRCLE 
command can draw many circles. The CIRCLE and ELLIPSE commands are absolutely identical. A 
simple but attractive example of circles is: 


100 FOR x = 1 TO 100: CIRCLE 50, 50, x*2, 0.3, x/20"PI 


MEMORY MANAGEMENT ; , 
The QL’s memory manager can allocate memory from the ‘common heap’ for use as reserved memory 
areas. Qdos also grabs some of this space to record microdrive and disk information (which is why 
the QL takes seconds to examine a microdrive on the first access and subsequently is content on 
subsequent accesses to affirm that the drive contains the same cartridge). CLCHP is short for CLear 
Common HeaP, and it does just that. Use this command with care. 


MEMORY MANAGEMENT 
When a SuperBasic program runs on the QL it needs memory space to record variable values, etc. 
CLEAR removes all trace of variables from the QL’s memory. Every time a procedure is called, the 
QL memorises the current state of variables which might have local assignments within the procedure. 
If a program is halted in the middle of a user-defined procedure or function call the computer still 
believes it is in the user definition. CLEAR clears this misunderstanding. 
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S$ FIWARE FILE 


SQUIDGY 
ROUND 
THE WORLD 


John Shaw finds this 50-screen arcade game anything 
but soft and damp, with excellent graphics. 
OF OD Sy OF OO FH OS 


INFORMATION 
Program: Squidgy round the 
World 

Supplier: CGH Services, 
Cwm Gwen Hall, 
Pencader, Dyfed, Wales 
SA39 SHA. 

Price: £10.00 (plus £1.00 
p&p) on 3.5 or 5.25 disk. 
£12.00 (plus £1.20 p&p) on 
two mdys. (Both must be 
supplied, formatted to 220 
sectors.) 


ored of BJ? Tired of 

Tetris? Beaten by 

Brainsmasher? Then 

here we are, a new ar- 
cade game from the stable of 
GCH Services and it's all about 
a friendly chap called Squidgy. 
The story goes thus: 

‘Squidgy came from a gravel 
pit in the Cotswold Lakes. He 
was given that name on ac- 
count of his strange skin. Vari- 
ous interested parties around 
the world want to perform ex- 
periments on him thinking he 
is a relative of the Loch Ness 
Monster or the Yeti.’ 

After booting up, the first 
scenario will show a poppy 
field. Avoid the snakes and 
pick the poppies. Once you 
have picked all of them you go 
to the exit. At most places } you 
exit mT aT off of the 


ely 
4 


playing area. 

Bombs! Avoid these at all 
cost as they are very tempera- 
mental; the smallest nudge 
could result in a nasty head- 
ache and they feature in every 
screen. 

Some locations look impos- 
sible to complete but there is a 
little cross hiddensomewhere 
which gives you limited tm- 
mortality. You can walk 
through three to five of your 
enemies before dying. Bombs 
always kill you. A little tip: 
you can also move diagonally 
— it's the only way through 
some screens! 

The Jumping Beans at some 
places are extra lives - very 
useful! Clocks increase your 


AR ee AURA RERT 
fi 


va 
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2; ; 


bonus time so you are more 
likely to get a bonus when you 
complete the place. If you for- 
get what you are supposed to 
be collecting then press the 
backslash (\) key which dou- 


bles as a pause key. If the 
various bleeps and buzzes an- 
noy you then you can press the 
pause button and TAB which 
will enable/disable sound. 

If you are very good and you 
visit all of the places (very un- 
likely unless you have the re- 
flexes of a panther) then you 
willrestartatlevel one but with 
increased speed. 

When you have lostall of your 
lives the game will finish and if 
your score was high enough 
you will be able to enter your 
name on the high-score table. 

There is a cautionary note: 
avoid running Squidgy on 
microdrives if you use a Min- 


erva rom that changes the ad- 
dress of system variables. It will 
run perfectly under Minerva 
from any other device. 

The playing format is a well 
tried one but it loses nothing 
for all that. The author has put 
a lot of work into the graphics 
and the whole thing runs 
smoothly and well. 


More difficult 


1 found it a very enjoyable 
game which I think is particu- 
larly suited to the younger ele- 
ment of the family. Don't be 
fooled by the ease of the initial 
few screens. There are 50 of 
them in all and they get more 
difficult as you progress. 

Good value for money and 
an excellent birthday present 
for your children. 
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driven editing functions and improved Name Table 


access. 


mong other treats, this DIY Toolkit 
instalment provides a ‘menu-driven 
front-end’ for SuperBasic program 
editing. It works rather like the 
procedure editor in Psion's Archive, and 
was suggested by keen QL World reader 
Anders Hartzellius of Sweden, who sent a 
prototype of the code. Anders wins the 
pick of DIY Toolkit disk volumes. 


All the names 


The functions DEF% and DEF$ dis- 
play amenu ofall the Basic procedure and 
function names defined in your program. 
You can move a highlight through the list 
and select any definition by pressing Space 
or Enter. The list scrolls if there are more 
names than will fit in the chosen window. 

As usual for DIY Toolkit, the functions 
are fast and reliable on all QL rom ver- 
sions. They adjust automatically to suit all 
Modes, window positions and character 
sizes. 

_DEF% works best with the ED screen 
editor command from Sinclair's QL Toolkit 
or Care’s SuperToolkit 2, or the equivalent 
in ABC Elektronic’s extravagantly named 
Gigatoolkit. You can also use it with the 
standard EDIT command, but if so you 
may like to change the default channel 
from #2 to #0. 


Underscore 


Anders’ choice of function names uses a 
leading underscore to prevent clashes with 
existing SuperBasic names. You can eas- 
ily change them with DIY Toolkit's ALIAS 
command if you don’t like typing the un- 
derscores. Thedifference between _DEF% 
and DEF$ is that_ DEF% returns the line 
number of the chosen routine, while_DEF$ 
returns the name, as a string. Both func- 
tions accept one optional parameter, which 
should be the number of a SuperBasic 
Con channel. Over 0 is assumed, but this 
is no limitation as ED and EDIT have the 
same requirement. 

The menu produced by DEF saves you 
scrolling through the program looking for 
the required definition. Procedures and 
functions make programs easier to read, 
not least because they allow you to refer to 
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routines by a meaningful name of your 
choice. Used on their own, ED and EDIT 
are a retrograde step as they require you 
to remember the line numbers as well as 
the name. Numbers are often confused 
and easily mistyped. 

You could use Toolkit commands like 
QFIND, LDEF or LOOKUP% to find a line 
from the name of a definition, but the menu 
approach is often preferable. It displays all 
the possibilities together. There is little risk 
of typing mistakes or mistakenly request- 
ing the first thing to come into your head. 


Altkey 


ED _DEF% is not too arduous a com- 
mand, but since you will use it every time 
you want to edit a SuperBasic procedure 
or function it makes sense to define it as an 
ALTKEY that can be called up with asingle 
stab at the keyboard. This Toolkit 2 com- 
mand calls up the menu, and the Toolkit 
editor, when you press ALT and the letter 
‘e’ at the same time: 


ALTKEY ‘e’, 'ED _DEF%' & CHR$ (10) 


If you find ALT ‘e' hard to find or remember, 
replace the letter ‘e’ with some other char- 
acter of your choice. The ALT key is in the 
right corner, near Enter. 

By default the menu of names appears in 
the listing window #2, but you can direct it 
elsewhere by adding the channel number 
in brackets after the function: 


EDIT _DEF% (#0) 


lf the window is very narrow or the names 
are very long they are trimmed to fit. The 
standard windows in F2 (TV) mode show 
the first 36 characters of long names. 
_DEF$ always returns the full name cho- 
sen. 


One direct 


The functions report ‘not found’ if there 
are no SuperBasic procedure or function 
definitions. If there is only one candidate 
name the functions select it automatically, 
as there is little point in presenting a menu 
with only one option. You can break out of 


the menu by pressing Ctrl Space or Esc. 
The same keys halt ED, but you need 
Minerva to interrupt EDIT with Esc. 

The routines behave predictably if there 
are duplicate definitions, or you change a 
name by editing the program. Imagine a 
procedure called CAT, renamed CATA- 
LOGUE later in the editing session. Both 
names appear in the _DEF menu, and you 
end up at the same line whichever one you 
pick. 


One definition 


SuperBasic’s Name Table only keeps 
details of one definition for each name. If 
you use the same name twice the menu 
option selects the most recent definition 
loaded, entered or merged. 

Ifa definition is deleted, or over written by 
MERGE so that new lines replace it, the 
name still appears in the menu; if selected, 
_DEF% returns the line where the DEF 
used tobe. Such antique names are cleared 
out if you SAVE and re-LOAD the pro- 
gram. Alternatively you can cancel them 
with DIY Toolkit commands. 

If NP is the index number of the deleted 
name, found with LOOKUP% or BASIC 
_INDEX%, you can remove it from subse- 
quent menus like this: 


BPOKE_W BPEEK_L (24) + NP * 8, 2 


This changes the type in the Name Table 
to ‘unset number’. If you accidentally can- 
celaname that still exists in your program, 
you can restore it to the menu by editing 
and re-entering the DEFine statement. 


Secret vector 


If your program has shortlines and many 
procedures and functions you may wish to 
expand the Buffer to make room for more 
lines. DEF% and DEF$ will automati- 
cally use the extra space, like MORE, 
INPUT and COPY. You can expand Buffer 
with an undocumented Qdos vector which 
works on all roms and emulators: 


CALL PEEK_W (282) +28, 1000 


| shall explain this, and other secret vec- 
tors, in my next DIY Toolkit column. For 
now, all you need to know is that the 
second parameter is the number of extra 
bytes required in the. Buffer. For all but the 
most enormous programs, 1000 should 
be enough as it makes room for at least 
500 name indices. 

You may not find the menu useful when 
you want to edit the main body of your 
program — the few lines that call the pro- 
cedures and functions that do the real 
work, These should come at the start, so 
you can get straight to them with the com- 
mand ED, without parameters. 

At first sight _NAME$ is just a concise 
synonym for Turbo  Toalkit's 
BASIC_NAMES, but it incorporates differ- 
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DIY TOOLKIT 


¥ QL World DIY TOOLKIT _DEFX, _DEFS, NAME® functions, version 1.5 


* tc) Anders Hartzelius 1991, DY changes {C) 1991 Simon N Goodwirt 
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sd_envkop 
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#3,d5 
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Extended operatian 

New Line trap key 

CLS trap key 

NOT OPEN error cade 
NOT FOUND 

BAD PARAMETER 

Offset to beyond Buffer 
O+#set to Mame Tabie 
Limit of Name Table 
Offset to Name List 
Offset, to Channel Table 
Lemrt of Channel Table 
Limit of RI Stack 

Basic e»tensiun vector 
Vector ta get integers 


Laad address af definitions 


Fetch the ROM vector word 
Initiate the new furnetiong 


Clear igh bytes 
Pick up the parameter 

Multiply @-G191 by 8 fast 
Find the Mame List offset 
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* 
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ehewrb liet 
Herr _bp,déd 


2tab,a5,1),dl 
#1,d01 

Dad cries 
Hid? 
stacker 


va_qtint\w,a2 
fal) 

deep err 
#1,05 

pret” Ob 

Herr _bp.da 

tui out 

lat, ae.1) dS 
bad_param 
#2,bv_rip (ad? 


¥I,d7 

shee f 

#1,d7 

dA? 

42,05 

at,aS 

derfaudt 

gael _an_int 
ferr_na, cle 
049,45 
by_chhasfaal, dS 
by chptaél,d5 
err 
#iaé,d5.1/,05 
ert 


Phew eqainst enc of Table 


Bad parameter, mo such name 
Fiek wp Name List vector 
Check at records o rane 


Indicate the recult type 


Yes: fetch charine! number 
Get integer 

Error ? 
One paramcter “ 


Had par ameter 
Report to basic 
DS: spar ameter 


Tidy RI Maths Stack 


Flag type ¢or _DEFX 


Flag type tor DEF® 

D7 ic used tor two purposes 
Default chanel 
Any parameters 
Ne: use defeult channel 
Check for one integer param 
Posit Channel not open 

DS: =affset in channel table 
fc base of channel Fable 
DS -> past end 7? 

Yes: repart errar 

DS: churnneh id 

Channel closed 7 


sit_ Bou 


clhrew 
addq. | 
cmpa.T 
beq.s 
move.b 
subg.ts 
bry. 
suibiqeh 
bne.s 
subqe] 
beq.& 
move. 1 
sibel 
MOET. bt 


beqg.s 
addq.w 
bra.s 


movea.l (tas),aa 


cmpa.l 
bne.s 
aoveq 
rts 
lea.l 
ipa. d 
hues 
onveq 
wns 
acd. 1 


mova. | 


bra 


d4 Reset Window full flag 
#8, a5 Nent entry in name table 
a5, a3 End of name table > 
end_nt 
@(a5,a6.1+,c03 
#4,d1 

pera fae 

#1, dE 

ot _loap 

Wide 

ened _rit 

aS,di 

byv_atbas lads itt 
Ut, Baz, ab.) 


DI: = name type 
Super BASIC. Pracechwe > 


Super RAS(Cl Fanctian 7 


Room for ene proc /” fn lene 
Don’t overflow the buffer 


Relative to start of Table 
Beffer offset in name table 


Test window full flag 

No printout rf set 
print_name 
Wed nd, de 
trap> 
et_loop 
H1,d4 
nk loop 


Met Tj ne 


Jump if not ERR_DR 
Wiricow full 
Next @rnbry im NT 


Anything in the butfer 2 
at,az 

ok 

Herr nf, da Not found 

Quit 1f no proc? fn 
2ladh,at Perhaps there’s only 1 7? 
al,a2 

choome 

#5, at 
Olas,ad.1l},d1 
Lee bbas (a6) il] 
d1,u5 6S is offmeh ineide BASIN 
draries Reborn the ceil y iame brie 


Tf more, use the men 
Frepare for ungagned maths 
DIt= inde@s is name table 
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ences and improvements which make it 
suitable in different circumstances. 

BASIC_NAME$ was designed to read 
the Name List of SuperBasic Task 0, 0 
from any task. NAME¢$ differs by looking 
in the local list, suiting Minerva’s extra 
interpreters and QLiberator(unless you use 
the NONAMES option to save memory). 
Turbo and Supercharge tasks do not 
contain a Name List, so they invariably 
report ‘bad parameter’ if used to call 
_NAME$. 


Obscure bug 


There is a very obscure bug in 
BASIC_NAME$, which does not affect 
compiled tasks or the Runtime Toolkit, but 
could cause problems if a task stops or 
starts at the wrong moment while 
BASIC_NAMES$ is being interpreted. The 
_NAMEG$ function has no such bug; it also 
rejects parameters that point at the Name 
Table but do not correspond to entries in 
the Name List. 

BASIC_NAMES$ gives a string of gibber- 
ish, typically mixing names like PRINT and 
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INPUT with control codes, if you inadvert- 
ently pass it the index number of an ‘ex- 
pression’ entry at the end of the Name 
Table. _NAME$ spots that there is no 
corresponding name, and reports ‘bad pa- 
rameter’ instead. 


Number of names 


_NAME$ expects a single integer pa- 
rameter with a value between 0 and 8191. 
In practice the highest valid parameter 
depends on the number of names in the 
current program and loaded as exten- 
sions. Every QL rom includes at least 113 
resident names, ranging from PRINT to 
VER$. 

The SuperBasic Name Table is limited 
to 8192 entries, as each consists of eight 
bytes and the Name List grows to match. 
Entries in the List are found via word 
offsets in the Name Table which can ad- 
dress up to 64K of data, and 64K/8 = 8192. 

The code in Listing one is derived from 
Anders Hartzellius’s original, updated by 
Simon N Goodwin. The version Anders 
sent worked well enough to demonstrate 


the utility of DEF%, but it had character- 
istic bugs that often afflict QL programs. | 
hope | have not overcomplicated the origi- 
nal design in the process of fixing it. 

Complete source, assembled code and 
documentation for these functions has 
been added to DIY Toolkit Volume A, 
where it joins ALIAS, CODEVEC and IN- 
VERSE. The single volume costs £7. 18 
volumes are available from DIY Toolkit, 
Cwm Gwen Hall, Pencader, Dyfed 
Cymru SA39 9HA, tel: 0559 384574. 
Each volume costs £3, plus £4 per order to 
cover disks, post and processing. Please 
enclose one cartridge per volume if order- 
ing microdrive copies. Bargain Bundles 
are now available, costing £20 for six 
volumes on disk, with SuperBasic, De- 
vices and Utility themes. Anders is work- 
ing on his own update to_DEF$ and 
_DEF%, which will appear in the Swedish 
QL Users’ Group magazine. 


Quick entry 


Listing two is a quick way to enter the 
code without using an assembler. It loads 
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the equivalent machine code from DATA 
statements, and saves the code in a file. 
Once you've loaded that file, as follows, 
youcanuse_DEF%, DEF$and—NAME$ 
in your own programs. 


base=RESPR (626) 
LBYTES “filename”, base 
CALL base 


The first part of Listing two is the standard 
loader used in every month’s DIY Toolkit 
project. Only the DATA, from line 590 
onwards, changes for each set of exten- 
sions. 


Customise 


Listing one was written and assembled 
using HiSoft's Devpac and the Computer 
One assembler. Type this text into your 
own assembler if you want to customise 
the code, | have added ‘A’ to some instruc- 
tions to placate pedantic assemblers like 
Metacomco’s ASM, but you may need to 
add similar tweaks if your program does 
not recognise ‘generic’ Motorola opcodes. 

The listing starts with a set of ‘equates’ 
or symbolic names for constants used 
later. Anders supplied a full set defined 
using hexadecimal values — hence the $ 
prefixes. More equates will be published 
next issue with the remainder of the list- 


ing. 


Quirk 


The START routine includes a Devpac 
quirk, the ‘\W’ after word vector values. 
Most assemblers take that for granted, so 
it can be missed out, but Hisoft need it to 
generate concise code — otherwise 
Devpac uses along address, wasting two 
bytes. 

Next comes the code for_NAME$. The 
subroutine GET_AN_INT reads the pa- 
rameter word, which is multiplied by 8 and 
used to find a Name Table entry. If the 
second word is -1 there is no name text; 
otherwise the routine returns the name as 
a string, using STACKER, part of the 
_DEF$ code. 


Difference 


The start of DEF$ and DEF% differ only 
in the ‘result type’ code loaded into regis- 
ter D7 and DEFN and DEFS. The program 
swaps this into the top word of the regis- 
ter, so D7.W can be used later to record 
the window width. 

If A3 and A5 match, the default channel 
#2 is used, otherwise GET_AN_INT is 
called to fetch and check the parameter, 
before looking it up in SuperBasic’s Chan- 
nel Table. AO is the identifier of a Con 
channel, which is blanked and then inter- 
rogated with two EXTOP calls. The high 


32 


REMark Sinclair QL World HEX LOADER v 3 
REMark by Marcus Jeffery & Simon N Goodwin 


CLS: RESTORE 
PRINT “Loading Hex...” 
INPUT “Save ta file... 
SBYTES f%, start, byte 


READ space: 


start-RESPR( space) 
HEA LOAD start 


',f 
STOP 


DEFine FuNetion DECIMAL(x) 
RETurn CODE(h$(x))—48-74¢h$(x)>"9") 


END DEFine DECIMAL 


DEFine PROCedure HEX _LOAD(start) 


byte = @ checksum 
REPeat load_hex_digits 
READ hh? ; 
IF h$="*" 
IF LEN(h$) MOD 2 


PRINT“'Od@ oumber of hex digits in: 


STOP 
END IF 
FOR b = 


hb = DECIMAL(b) 


= @ 


1 TO LEN(h$) 


EXIT load_hex_ digits © 


“She 


STEP 2 
Ib = DECIMAL(b+1) 


IF hb<@ OR hb>15 OR Th<@ OR 1b>15 


PRINT"Illegal hex digit in: 


END IF 


“Shs STOP 


POKE startt+hyte, 16*hb+1b 


checksum = 
byte = byte + 1 
END FOR b 


ehecksum + 16¥hb + db 


END REPeat load hex digits 


READ chock 
IF eheeck <> cherksum 


PRINT"Checksum incorrect, 


END IF 


PRINT"Checksum correct, 


END DEFine HEX_LOAD 


Recheck data. ": STOP 


data entered at: “j start 


REMark Space requirements for ‘the machine conde 


DATA 626 


REMark Machine code data 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


word of D4 becomes the character height 
in pixels, and the halves of D5 hold the 
INK and STRIP colours. Anders likes D5. 


Identity 


The next step is to identify all the 
SuperBasic procedure and function 
names. This involves loading address 
registers with internal table offsets. A5 
and A3 point to the start and limit of the 
Name Table inside Basic. A4 points at the 
Name List, and A2 points at the start of the 
Buffer. 

Buffer sizes vary from 128 bytes to 32K 


"43FA02Z5934780110' 
“2B6EGO292A6EOO18' 
“FOF L4E753236D802" 
“@1A4347801124E92" 
"“BBOBE17ABA31 HBOS" 
"7EO3 6002 7EO148 47" 
“TOF ACAFCOM2Z8DAAE " 
"2A3658O06BD8 2045" 
“4B FAA1BR7AGI6 18H" 


', “4ED27A906 124E7 4D" 


» DBCSBBRE@@1 C6BCG4" 
, 5241677 47EG1 600" 
, 669653836706 70F 1" 
» 6BF454AR@@G584R75" 
» “TAD2BBCR670261D2" 
» PB3IGBAAEOOS46CDE" 
,  76FF7 0296 1A08132" 
, @M12Z2B83EG1280145FA" 


or more. Each name on the menu needs 
a word, so! calculate the number of words 
available and store It in D6. The low word 
of D4 is used as a flag, initially zero while 
the menu is drawn. 

The program prints names of type 4 
(DEF PROC) and type 5 (DEF FN) to the 
screen as they are found, until an 
‘ERR_OR ' out of range error occurs when 
SD_NL is called to move to a new line. 
The error is trapped and D4 is set to one, 
suppressing further output, but Name Ta- 
ble offsets continue to be stored in the 
Buffer until the end of the table is reached 
or D6 counts down to zero, indicating that 
the buffer is full. 
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DATA 
DATA 
DATA 
DATA 
BATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
1820 DATA 


"O19C74Y961GOO11A", “ZASP1LZAGEOSG1LEZ66E" 
"“OO1C286HO0202456", "2C2ESOOBSCBARCBE" 
“AZ 44508DB7CD6730", “123 5E8G859016784" 
"53@166EE53866720", “220D92AR00183581" 
"E8005 48A4A4466DA", “61980GBA70126100" 
"OODOGB7 CH5 2446BCA", “2Z656B5CBE66H478P9 ™ 
"4E7 543EBOOO2 BSCR", “66107 2ZUHI233KBBO" 
"D2AR@H1B 244169068" , “OBCB7 2887 4BO7 G18" 
"“B1IOPOMGEIS447 208" , “3I233E8G@D2ZAEOG18" 
"24416 108@09R616C"., “6198899870016 120" 
"@G8BB23COO1BE66A6", "7 OF FEGBOBPIS2B23C" 
“POBAB 7 ALGOBCB23C" , “QB2067GGOGB4B23C" 
“@BDGBEGABTDESH7D4", “SS8B7CLOBMLAB2]3C" 
"@BDB66C87C16546B", “B7CAGBS4556BG0BC" 
"7F2G0O07O01L1613A611C", “20866134679E7818" 
"3204BC7C@S156702", '4441612472007011" 
"BLL E6OB270GOG3035", “EBG2ZDOBC22 4097 400" 
"143 1N8OOB4476BO2", "340752897007 4h44" 
“4h 434A8067098BO7C", “FFFCB7O2589F 4480" 
“4E752290548457028", “6G1E64841702960ER0" 
"424748 47226E0058", “720ZBE3C@9036712" 
“TPOOIDI5EBHG2ZD9CH", “D234E800524198B1" 
"@ODOS2CH1347EO11A", “4EB2226E005893C6 " 
“2D49965BBE3COOB3", “6GEBCI3SBSEBO4EBOH" 
"2807 70004E755546", “4231 H80O13B4E800" 
“E8@1528C52895i1CE", “FFF460E472901228" 
"@945484112290846", “6OD8B72993228GG1C" 
"3428002682C25341", "4841322808284841" 
"“6BCOESLOGAOAAGO3", “FDB2ZG65F4E414D45" 


“24QGFDF2055F4445", “4624FDE6055F 4445" 
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Listing one refers to several labels in the 
second part, which has been held over till 
next month because of limited space. 
CHOOSE labels the routine which allows 
a name to be selected from the menu. 
DONE and STACKER return the function 
result to SuperBasic. QUIT_OUT returns 
the error code in DO, discarding the last 
return address with ADDQ.L #4, A7 so the 
program returns directly to the original 
caller. 


Subroutines 


GET_CSIZES and GET_COLOURS are 
EXTOP subroutines which read values 
from the Channel Definition and return two 
each, in register D1. PRINT_NAME is 
called with A5 holding the offset of a Name 
Table entry; it prints the name to the chan- 
nel specified by the ID in AO. TRAP3 
performs TRAP #3, returning only ERR_OR 
or ERR_OK. Other errors are propagated 
to QUIT_OUT. 

Next issue | shall conclude the assem- 
bler code and commentary for these func- 
tions, and explore the table of Qdos vec- 
tors, documenting and explaining uses for 
vectors that have never before been pub- 
lished. DIY Toolkit continues to extend the 
QL and compatibles with concise general- 
purpose routines that make the machine 


1@1@ DATA °4625","*", 52617 


easier to use and program. | welcome 
suggestions from readers, care of QL 
World. 


A ngeriauriine 
Wilfried Krummrey 
Postfach 47 O4 4I 
D-IOOO Berlin 47 


QL Hardware QL Software 


QDesign 


Das erstklassige Grafikprogramm fiir den Sinclair QL. The best graphics program for the Sinclair QL. 
QDesign deutsch oder/or english DM 111,-/£37 
Fur/For HP LaserJet, DeskJet, InkJet: QDesign Laser deutsch oder/or english DM 129,- /£ 43 


VecEdit 


Der Vektorfont-Editor fir QDesign. The vector font editor for QDesign. 
VecEdit deutsch oder/or english DM 54,-/£18 


Neat) SYSTEM nea 


Die Systemerweiterung und Erganzung zum Toolkit Il. Mehr als 60 neue Befehle. UNIX-feeling auf dem QL. 
This Toolkit starts where TK2 finished. More than 60 new commands. Unix feeling atthe QL. 
SYSTEM deutsch oder/or english DM 99,- / £33 


QL-Tastatur-—90 


Das erste vollkompatible QL Tastaturinterface. The first fully compatible QL keyboard interface. 
QL-Tastatur-90 deutsch oder/or english DM 149,-/ £49.70 


FOR AUSFOHRLICHERE INFORMATIONEN: FORDERN SIE BITTE UNSERE KOSTENLOSE PREISLISTE ANI 
FOR MORE INFORMATION: PLEASE ORDER OUR FREE OF CHARGE ENGLISH PRICE-LIST! 


Alle Preise sind Exportpreise excl. VAT vorbehaltlich Liefermdéglichkeit. 
Versandkostenpauschale DM 10,~/ £3.50 bei Vorkasse durch Verrechnungsscheck oder Postanweisung. 
Exportprices excl. VAT. E&OE. Please add DM 10,- /£ 3.50 for postage. Payment: Cheques or Postal Orders. 


FIWARE FILE 


INFORMATION 

Program: Disk PD1 

Price: Call supplier 
QUBBESoft P/D 
38 Brunwin Road 
Rayne 
Braintree 
Essex CM7 5BU. 
Tel. (0376)-47852 


he review disk has 
been sitting, patiently 
awaiting attention for 
several months, and 
thereare now additional public 
domain disks available from 
QubbeSoft. Specifically, a C 
Janguage compiler is being 
offered. PD programs are 
relatively few and far between 
for the QL, but low prices are 
appreciated, so there is the 
chance for a PD supplier to be 
modestly successful. 


Unusual 


Aninitial look at the contents 
of disk PD1 suggested we had 
something a bit unusual here. 
Several files are of zero size, 
and a View of the boot file 
showed it to consist almost 
entirely of the ‘splodge’ 
characters that non- 
programmers find so 
mystifying. Nevertheless, itran 
and produced a good, clear 
screen, listing the programs 
supplied on the disk. A 
highlight bar can be moved 
over the programs, and 
running a program isas simple 
as pressing ENTER when it is 
highlighted, with the exception 
that CTRL-C has to be pressed 
subsequently to grab the cursor 
for some EXECable programs. 
The programs listed were 
Imagix diamond edition V4.30, 
The Cataloguer V1.12, Touch-it! 
V2.15, The Mandelbrot Machine 
V1.69, Tools V1.07, Variable 
Memory Shrink V2.50, Soft 
Eprom V1.00, Super Kit Merger 
V1.00, Qpuzzle V1.00 and Cotit/ 
Km et Amort V1.00. 

It is quite likely some of these 
programs have reached later 
versions by now. One thing it 
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Qubbesoft is a new name on the 
public domain market. Bryan 
Davies looks at their first disk. 


is unreasonable to expect at PD 
prices is a book of instructions, 
and one can grind to a 
temporary halt at the first 
screen of the first program, 
wondering not only what todo 
next but also what the program 
is for. magix turned out to bea 
screen dump utility, with a 
large selection of parameters. 
Output quality is good. In view 
of the uncertainty of what was 
being entered into, the first 
print was initiated by pressing 
ENTER for every selection on 


the menu; this minimalist 
approach turned out to be 
satisfactory for a demon- 


.stration of the program’s 


capability. 

The dump handled all four 
basic colours of Mode 4 well, 
which is something the 
SDUMP command in some 
interfaces doesn’t seem to do 
without ‘tweaking’. There was 
little trace of the horizontal 
white lines which often spoil 
dumps of largely-black 
backgrounds. There are 


enough variables to enable the 
user to select and size screens 
to suit any requirement; a 
moving bar indicates how far 
the dump has progressed. A 
neat little program. 

The Cataloguer lists the files 
on disks or microdrive | 
cartridges, to the screen or a 
printer. Itdoesn’t cater for hard 
disk. The listing to both screen 
and printer were good from 
flp1_(orfdk1_), but no listings 
were obtained from the other 
proffered devices - flp2_, 
fdk2_, mdvl_ and mdv2_, It 
would have been useful to be 
able to write listings to a disk 
file. 

Touch-it isa macro-generation 
routine, [t allows you to write 
macros for recall with the ALT 
key plus alphanumeric keys, 


Tools - the screen save worked fine, but the on/off switch didn’t. 


L WEREEECE 
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rather in the fashion of the 
Toolkit ALTKEY function. For 
a user who does not have an 
interface with Toolkit 
functions, this could beacheap 
way of obtaining one of the 
most useful of them. A RESPR/ 
LBYTES/CALL command line 
is needed, to load the supplied 
extentions files and make the 
creation of the macros possible. 


Fractals 


} We see so much mention of 
| fractals and Mandelbrot that it 
| might seem no computer is 
complete without a program 
to generate fractal patterns. 
Unfortunately, one of the 
features of these patterns is the 
long time taken by some 
programs to display them on 
the OL screen. This doesn’t 
appear to be a particular 
problem with The Mandelbrot 
Machine, but my knowledge of 
what fractal patterns should 
look like is insufficient to judge 
whether or not those produced 
by the program are authentic. 
They look reasonable, though. 
There were plenty of 
parameters to vary, and a Help 
screen. 


Tools 


The next program on the list 
is Tools, and this displays a 
menu of four options — ‘switch 
the screen off/on, kill job 
definitely, switch status line, 
save screen to flp1_’. The first 
option worked instantly, 
making the screen black assoon 
as CTRL-F1 was keyed. Despite 
the impression given by the 
menu text, it did not turn the 
screen back on again when the 
same keying was used, leaving 
the choice of either waiting an 
uncertain time to see if it came 
back onagain of its own accord, 
or resetting. After more than 
five minutes wait, the latter 
seemed the only course open. 
The second option did what it 
said, removing Tools from the 
task list. The status line appears 
across the top of the screen, 
giving the current date and 
time, the network number, the 
CAPS LOCK key status, and 
two items labelled ‘RAM’ and 
‘SCR’. Presumably, the former 
indicates free memory in KB; it 
showed 777 on my system, 
which was about right. The 
latter may be a reference to 
screen window number, or 


' Sincteitera Waite fubiuesy 160% 


of OL Le a 


Uy crassa EPAE pour dessiner 
4 


-UTILISE2 LES FLECHES POUR 
CHOISIR LE BLOC A MQUUOIR 
<ESPACE> POUR DEPLACER CE 

BLOC, <ESC> POUR GUITTER, 


Qpuzzle - good for your French 


number of windows, The 
screen save worked fine (see 
the illustration of Tools V1.07 
screen). 

There may not be too many 
occasions when you wish your 
system had less than the 
installed amount of memory, 
but disk/memory interfaces 
tend to have a command for 
reducing the utilised memory 
to 128 KB, to allow the use of 
programs which work only 
with that amount. The Variable 
Memory Shrink routine extends 
the options to 128/256/384/ 
512/640/768/896 KB. The last 
value seems a bit odd, being 
the maximum one could 
normally get (until the advent 
of the Gold Card). The function 
works, although it is a bit 
disconcerting to find a Trump 
Card made useless (apart from 
its memory), neither TK2 nor 
the floppy disk driver being 
available. The Trump Card 
command, RES 128, does at 
least leave you with disk drives. 
The 768 KB value proved to be 
unavailable, causing the 
program to halt, but all the 
other values worked. 

SoftEprom was not something 
that could be checked on my 
system. Its function appears to 


be to alter the memory address 
of an eprom cartridge. 

Super Kit Merger appeared to 
be something that would be 
quite useful —a sort of filter, to 
get rid of duplicate extensions 
to the Qdos command set. If 
you've ever used the Toolkit 
command EXTRAS»: and 
inspected the list presented on 
the screen, you are likely to 
have wondered why some 
‘names’ appear more than once. 
The duplicates not only take 
upmemory space but they may 
cause problems if there is more 
than one apparent response 
available whena program calls 
a function. Unfortunately, the 
small list of extensions files 
given to Super Kit Merger to 
digest and reduce toaslimmer, 
single file just caused it to halt 
without any explanatory 
message. A second, smaller list 
resulted in a ‘newly-created 
toolkit’ which was four bytes 
in size - not likely toadd much 
to Qdos! Two more attempts 
resulted in one more each of 
the same results. 

Qpuzzle starts up with a very 
striking, flickering border 
around a few introductory 
words (the illustration doesn’t 
do it full justice); the words are 
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French except for ‘PUZZLE’. 
As with tv, seeing something 
on the screen in another 
language can make it somehow 
less boring than when it is in 
one’s own language. In fact, 
this program is perhaps the best 
of the bunch. It is essentially 
one of those games where you 
move blocks on a board to get 
a certain pattern, but in this 
case the program does it for 
you. You simply sit back and 
watch the squares moving, 
Leastways, that’s how it 
seemed at first — until the 
instructions were deciphered. 
What you have to do is take 
over from the computer and 
use the cursor keys and press 
Space until the pattern is 
correct. The pattern is a No 
Entry sign, into which the form 
ofa ghost clambers. Very nicely 
done. 

The last program is entitled 
Coiit/Km et Amort V1.00, which 
may not seem anything to the 
average English-speaking user, 
but it is a simple calculator to 
tell you how much your 
motoring is costing, ona Francs 
per kilometre basis, and also 
the yearly depreciation. There 
are 18 headings to give 
information under, so brush up 
on your French! 


Errors 


There were the usual prob- 
lems, such as untrapped (and 
unexplained) errors, withsome 
of the programsas is usual with 
commercial items at the lower 
end of the price scale. Users 
could learn to live with most of 
them, but it looked as though 
more program testing (maybe 
on more OL versions) is desir- 
able. The lack of written or disk 
file instructions is, to some ex- 
tent, balanced by Help screens, 
but you would need to print 
these out. The uninitiated user 
would have little idea of what 
some of the parameters are for. 
Screen presentation is good, 
and it is clear a fair amount of 
thought has gone into both this 
and the basic mechanisms of 
the programs. All of the pro- 
grams are credited to the same 
person, incidentally. The disk 
would provide an interesting 
few hours, and might give 
some ideas to those developing 
their own programs. Atnormal 
PD prices, there's little to lose. 
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To play the game, select a 


dures, mostly devoted to 
graphics co-ordinates. Type 
level of difficulty from 1 to 5. 


these in very carefully! 

Watch the screen as the mur- 
der is committed and the 
murderer's face comes into 
view. You will then be taken to 
the police station to build up 
the identikit. Select each facial 
feature from a menu using the 
up, downand Return keys. The 
program will then award 
points according to how close 
you came to describing Jack. 
Only if your description is 
perfect will you have the 
pleasure of seeing Jack behind 
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code tutorial. 


n this series, we are building up a 

library of small chunks of assembler 

language code. Each of these will do a 

recognisable job within a program, and 
be fully annotated, so that itis clear exactly 
how to join them to other chunks of code to 
make a program, and, in particular, how to 
make any necessary changes to make the 
chunks fit together. 

Inthe first part, we looked at some simple 
chunks of code to enable us to get started 
and write a usable program. In the second 
part, we put together a simple, but useful, 
multitasking program. 

Many programs that actually work well 
are thoroughly irritating to the user, and 
most of that irritation is caused by a poor 
screen display. Being able to control, and 
modify, the screen output, while the pro- 
gram is running, is the one major require- 
ment for a professional, user-friendly 


tasting 1 


; WINDOWED 


7 THE INFORMATION CAN BE RETURNED IN TWO FORMS, 


no NOT HAVE 10 BE ENTERED AGAIN. 


Machi 


TN Te 


(1 A km REI IEE aE at Ee Re ee 
3 THIS ROUTINE WILL FIND THE SIZE OF THE WINDOW AND POSITION OF THE CURSOR 
» FHE INFORMATION 1G STORED IN 4 WORDS STARTING AT THE BASE OF ENRBLOCK. 
DEPENDING ON VALUE IN DO, 


} #* NOTE #* THE DATA IN AO AND DS IS PRESERVED BY THIS ROUTINE, 8O IF THE 
3 MEX) CHUNK GF CODE [8 ANOTHER TRAP #3 CALL FOR THE SAME CHANNEL, THEY 


stematic 


Code 


Programming 


Part three of Alan Bridewell’s modular machine 


ne 


screen display. This means being able to 
pan, scroll, or clear the screen (or part of 
it), change ink and paper colours, change 
window size, change border size and col- 
our, change character size, precisely po- 
sition the cursor, and draw lines and blocks 
on the screen. 


Two groups 


We can conveniently divide these up into 
two groups; the easy, and the not so easy. 
And what is it that makes some easy and 
others not? Answer: ‘floating point arith- 
metic’. For most people programming in 
SuperBasic, a number is a number is a 
number. Any variable can be assigned 
any number (within the limits of the com- 
puter). The slightly more sophisticated will 
distinguish between ‘Integer variables’ 
(those ending in a ‘%' sign) and the others 


Listing S 
SHSHSHEEEEEHEE HEC EER OOH 


Ne a ttead 


5 OO = £A RETURN DATA IW PIKELS THE BORDER COLOUR 16 A BYTE IN Di AND BORDER WIDTH IS A WORD IN D2 
7 DO = 3B RETURN DATA TN CHARACTERS. THE DATA IN THIS FORM THE WINDOW SIZE AND POSITION IS IN A BLOCK STARTING AT WDEFINEBLOCK 
: WILL VARY ACCORDING TO THE CEIZE AT THE CURGOR POSITION. 
1 «MDEF MOVE.L (A7) AO 3 OR 4(87),A0 OR GI(A7) ,AO ETC 
~WENG MOVE.L 1A?) AO + OR 4(A7),A0 OR B(A7),A0, ETC. 3 CONSOLE CHANNEL ID IN AG 
SCONES: & CHANNEL ID TN AO LEA WDEFINE,Ai » WDEFINE BASE IN Ai 
LBA.L ENQBLOCK,AI 4» BASE OF EN@BLOCK IN Al MOVER #*D ,DO 3} *SD_WDEFINE IN DO 
MOVES #8A,D0 .) @SD_PKENQ IN DO (PIXELS) oven #s2,D1 } RED BORDER 
1 OR #*8,D0 #CHENG IN DO (CHARS? MOVE. W ##10,D2 .) BORDER 14 PIXELS WIDE 
MOVE , SSFFFF DS 5 INFINITE TIMEOUT MOVE. Ww @SFFFF,DS 5 INFINITE TIMEOUT 
rrRaP TRAP es 
BRe. 8 NEXTBIT 5 SKIF BLOCK a NEXTBIT 


DO NOT HAVE TO BE 


THIS WILL COMPLETELY REDEFINE THE SIZE, 


## NOTE #*® THE DATA IN AO AND DS 18 PRESERVED BY THIS ROUTINE, BO IF THE 
NEXT CHUNK OF CODE IS ANOTHER TRAP #3 CALL FOR THE SAME CHANNEL, 
ENTERED AGAIN. 


(usually referred to as ‘floating point’ or 
‘real' variables). Integer variables can only 
have whole number values over a limited 
range. They are supposed to compensate 
for this by being processed much faster by 
the QL. (In actual fact they're not. This is 
because the poor old QL spends so much 
time interpreting what the instructions ac- | 
tually mean, that you lose all the advantage 
of the faster processing. When you com- 
pile your SuperBasic, though, they are 
much faster.) 

As far as the microprocessor is con- 
cerned, the difference is this. The floating 
point numberis stored in apeculiarly coded 
form that needs Qdos routines to unravel. 
However, integer numbers are stored ina 
form that the microprocessor can load 
straight into its registers, and manipulate 
directly. Hence the speed and ease of use. 
In this article we shall restrict ourselves to 
the easy chunks of code requiring only 
integers. 

These are all what we call TRAP #3 calls 
to Qdos. This means that the routines in 


A a A A 
“WDEF TNE * 

18-0 4 A A Hl a 

POSITION AND BORDER OF & WINDOW 


) SKIP BLOCK 


THEY 


t BLOCK FOR THE RETURN OF WINDOW INFORMATION 


BLOCK CONTAINING WINDOW SIZE AND POSITION INFORMATION 


tT 
. BNO ELOCK 


pDC.wW o FOR K DIMENSION OF WINDOW 
DC.wW Oo ; FOR ¥ DIMENSION OF WINDOW -WDEF INE BC.W 256 } 254 PIXELS WIDE 
pt. w o 3 FOR X POSITION OF CURSOR DC.W 64 5 64 PIXELS HIGH 
Do, Ww ° 5 FOR Y POSITIGN OF CURSOR DC.W ° 5 X ORIGIN 

oc. W o 5 ¥ ORIGIN 


t 
[PAPEETE ENS SS SERS ORE EEE RENEE SEE EEE COS Ee , 
{FARRER OR EEEERHREEER ERE OOTH TELNET REN OEE EATER 


Listing 2 Listing 4 
EE AAAS EEA E EERE ERAN EERE REA ATER EEE REESE RRR RE RE EERE 
“BORDER ' 
AEE AEP 
THIS ROUTINE WILL REDEFINE THE BODER S12— AND COLOUR IN THE WINDOW. 
ADJUST THE BYTE IN D1 FOR COLOUR, AND WORD IN D2 FOR BORDER WIDTH, 
e# NOTE e* DEFINING THE COLOUR AS #$80 WILL MAKE THE BORDER TRANSPARENT 
S80 THAT ANY TEXT OR GRAPHICS FALLING WITHIN THE NEW BORDERS WILL NOT BE 


HE aE ae ea ae AE HAE DE a EEE 
; ‘CURSOR * ’ 

Salthill haha liadahahatialachatattalhcchahataditahihatedatedtdedehshaieteh del did ddaiddidaied tduhabdddeideh ath, thd 
; WILL ENABLE OR SUPPRESS THE CURSOR IN THE WINDOW, DEPENDING ON THE 

; VALUE IN DO 

3 

; 

i 


DO = $E ENABLE CURSOR 


OVER-WRITTEN BY ANYTHING SUBSEQUENTLY WRITTEN IN THE WINDOW, DO = $F SUPPRESS CURSUR 
BORD NOVE.L (A7),AO —; GR 4187),A0 OR AIA?) AG ETC. . CURSOR MOVE.L -LA7},AQ 5 OR 4(47),A0 OR B(A7),AO ETC. 
) CONSOLE CHANNEL ID IN AO ; CONSOLE CHANNEL ID IN AO 
NoVEG #8C DO } #8D_AORDER IN DO MOVER #$E, DO } WSD_CURE IN DO (ENABLE) OR 
MOVEG #32,D1_ 5, BORDER RED : } #$F,DO SD_CURS IN DO (SUPPRESS) 
MOVE.W = #810,D2 y ‘BORDER 16 PIXELS WIDE MOVE.W  @SFFFF.DS INFINITE TIMEDUT 
MOVE, 0 #SFFFF,D3 y INFINITE TIMEQUT : D3 3 
TRAP 43 TRAP az 


** NOTE ** THE DATA IN AO AND D3 [5 PRESERVED BY THIS ROUTINE, 50 IF THE 
NEXT CHUNK OF CODE 13S ANOTHER FRAP #5 CALL FOR IHE SAME CHANNEL, THEY 
DO NOT HAVE TO BE ENTERED AGAIN. 


j 

} t# NOTE *# THE DATA IN AO AND D3 IS PRESERVED BY THIS ROUTINE, SO IF THE 
) NEXT CHUNK OF CODE £8 ANOTHER TRAP #3 CALL FOR THE BAME CHANNEL, THEY 

; DO NOT HAVE TO BE ENTERED AGAIN. 

' 

5 
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Qdos are doing the real work. All we are 
doing is putting in the appropriate param- 
eters, then telling Qdos to get on with it. 
They all require at least three parameters. 

In register DO, itneeds a byte to tell Qdos 
which routine to carry out. 

In register D3, a word is needed for 
timeout (that is, how long the program will 
wait until the channel is ready to receive 
the command before it gives up trying to 
carry it out). With screen commands, | 
have yet to find a reason why timeout 
should not be infinite, that is, the program 
will wait until the command is successfully 
completed. The number for infinite timeout 
is -1 or #$FFFF in hex twos complement. 
(If you don't know what that is, don't worry 
about it for now. Your assembler will al- 
most certainly deal with it for you.) 


Channel ID 


In register AO we need the channel ID of 
the window we are dealing with. If this 
window was opened by the program, the 
ID will almost certainly be on the stack, 
quite possibly at the top. Frankly, ma- 
nipulating a window from one program 
which has been opened by another (even 
#0, #1 and #2 from SuperBasic) means 
either rather crude programming, or you're 
attempting something really subtle! As a 
rule, every program should have its own 
windows, and leave all others alone. The 
only exception to thisis with error messages 
from Qdos, which normally go to one of the 
SuperBasic windows. (After all, inthe case 
of an error, your program may not have a 
window to print error messages!) 


Listing 5 


A A A a ah A A a I Ea a a a ede a 


‘POSIT IGNCURSOR * 


MOVES THE CURSOR TO AN ABSOLUTE POSITION IN THE WINDOW LISING EITHER 
CHARACTER OR PIXEL COORDINATES, DEPENDING ON THE VALUE IN DO. 


Some of these chunks of code require 
other numbers (for colours, sizes, dis- 
tances, etc.) and some require the ad- 
dress of a parameter list, or some ram set 
aside for a reply, when Qdos has been 
asked for window information. 

When | first embarked on the job of putting 
together this library of chunks, these TRAP 
#3 calls gave me much cause for thought 
and experiment. Basically, what we are 
dealing with is some 34 different calls to 
Qdos which do 34 slightly different things 
to the screen display. In many cases the 
difference in code is only one byte, so it 
seemedto be rather over the top to produce 
a separate library item for every call. On 
the other hand, to put them all together as 
one library item would mean adding a 
great deal of remarks to explain how to get 
itto do all the different jobs. It would be just 
like reading the manual again. 

What | have done is group them together 
in 17 chunks which are similar enough to fit 
logically together (in my mind at least!). 

'Windowenq' (Listing one) will find the 
size of the window and position of the 
cursor, and place them in a block of ram 
starting at the address in register A1. The 
information is returned as 4 words as fol- 
lows: 

At address in A1 X dimension of window 
address in A1+2 Y dimension of win- 
dow 
address in A1+4 X position of cursor 
address in A1+6 Y position of cursor 

The information is returned either in pixels, 
or in characters, depending on the value in 
DO - $A for pixels, and $B for characters. 
It is worth noting that if the information is 


Listirg 7 


CURRENT ROW. 


MACHINE CODE 


returned in characters, it will depend on 
the Csize value for the character at the 
cursor position. A similar consideration 
occurs with other commands involving 
character co-ordinates. 

‘Border’ (Listing two) will redefine the 
size and colour of the border. It requires a 
byte for the colour in register D1, and a 
word for the border width in register D2. 
The value required in register DO is $C. 

An interesting use of this is to make the 
border colour $80, which gives a transpar- 
ent border, the text remains even when the 
rest of the text scrolls off the screen, or is 
removed by a CLS command. We shall 
make use of this in the next program we 
put together. 


Window position 


'Wdefine' (Listing three) will completely 
redefine a window (position, size, shape 
and border). This is very useful if you wish 
to position text or graphics just once in 
various parts of the screen without a suc- 
cession of opening and closing of lots of 
channels. When the window is redefined, 
the contents of the old window position 
remain until they are over-written. Inter- 
esting results can be produced by making 
the new window partially overwrite the old. 

The value required in register DO is $D. 
As with ‘Border’, register D1 requires a 
byte for border colour and register D2 
requires a word for border width. The 
window parameters must be stored in a 
parameter block the base address of which 
must be in register A1. The information is 
required as four words as follows: 


AE AE eae ae a A aE AA de a a A a 


‘TABS 


He IE EAR I AE AEE IR FAR I AE IE aE FEE EAE Se AH HAE dE A A A A eda a a Hl de 
MOVES THE CURSOR TO THE COLUMN NUMBER GIVEN BY THE WORD 1N D1 IN THE 


5 
: 
CL Lolth shehehah sheheh shal stl tetehehatetishehahehehalahehudeheheiahehahahehadandiedaiedaiahshehabshahadabsheideheaiabetehiiaieiehibuaaiahel § 
3 
i 
; 


BO = #10 USE CHARACTER COORDINATES. REQUIRES A WORD FOR THE 


‘ 
i 
' 
i 
' 
i 
; COLUMN NUMBER IN Dt AND & WORD FOR THE ROW NUMBER TAB nove. t 
i 

; 

; 

3 

r 


(a7), AG OR 4(A7),80 OR 81A7),A0 EI, 
CONSOLE CHANNEL ID [N AO 


5 

IN D2. ‘ 
#F11,00 + #SD_TAB IN DO 

é 

+] 


USE PIXEL COORDINATES. REQUIRES A WORD FOR THE 
X% COORDINATE IN Di AND A WORD FOR THE Y COORDINATE 


MOVE 
MOVE. 
MOVE. W SSFFFF OS 
TRAP 5] 


DO = #17 
9640.01 TAB TO COLUMN 64 


INFINITE TIMEOUT 


CAT) , AO OR 4(87),80 OR HIA/),AO ETC. 
CONSOLE CHANNEL 10 IN AG 
#SD_POS IN DO (LHARS), OR 


3 

; ; «» NOTE ** THE DATA IN AO AND D3 1S PRESERVED BY THIS ROUTINE, SD IF TH 
3 

j #817,D0 #SD_PIXP IN BO (PIXELS) 

3 

3 

3 


NEXT CHUNK CF CODE IS ANOTHER TRAP #5 CALL FOR THE SAME CHANNEL, THEY 


+ 
Seale ; DO NOT HAVE TO BE ENTERED AGAIN. 


710,01 
##20,02 
@SFFFF DS 
43 


COLUMN 16 
ROW 32 
INFINIFE TIMEQUT 


6 ate AE SE AE AEE BE ae Ee FE ee TE AE EE EE ae 


4 

3 4" NOTE =* THE DATA IN AO AND D3 1S PRESERVED BY THIS ROUTINE, SO IF THE 
3 MEXT CHUNK UF CODE 1G ANOTHER TRAP #3 CALL FOR FHE SAME CHANNEL, THEY 

; DO NOT HAVE TO BE ENTERED AGAIN. 


* 
fT Ae EEE REA REN ee Listang & 


Listing & 
RE Ee Ee a He 
Perrvrerriitiie fret titre Ti tt iti ttt itt te tice rirrr rotor o ei rerio es 1 "tLe" . 
“MOVECURSOR * ' s talhathathadaaeciatatintaiiataiahahataiehshahstehatehadetidedideddedidbadddetehidihdbdeddddtak ddl dak botekotedatotok 1kkk-4.k 
A A A A EE A RH a aH i CLEARS ALL OR PART OF THE WINDOW. 
THIS MOVES THE CURSOR TO & NEW POSITION RELATIVE TO ITS OLD POSTTION. + WHICH PART 18 CLEARED DEPENDS ON THE VALUE IN Dd. 
THE MOVEMENT IS IN CHARACTER PUSITIONS, AND DEPENDS ON THE VALUE IN DO. 1 DO = $20 CLEAR WHOLE WINDOW 
DO = $12 PERFORMS @ ER, LF, PUTTING CURSOR AT START OF NEXT LINE 5 #21 CLEAR WINDOW ABOVE CURSOR LINE 
MOVES CURSOR TO THE PREVIOUS COLUMN {LEFT> ‘ #22 CLEAR WINDOW BELOW CURSOR LINE 
MOVES CURSOR TO THE NEXT COLUMN (RIGHT) i #25 CLEAR THE CURSOR LINE 
MOVES CURSOR TO THE PREVIOUS ROW (UP) i $24 CLESR CURSOR LINE TO THE RIGHT OF THE CURSOR, 
MOVES CURSOR TO THE NEXT ROW (DOWN) 3 INCLUDING THE CHARACTER UNDER FHE CURSOR 
i ‘ 


DO #13 
no #14 
Do 15 
po #14 


4 
q 
1 
' 
i 
5 
a 
3 
' 
‘ 
' 


ROVE .L [A72 AO GR 4{A7),A80 OR BIA7),AG ETC. 
CONSOLE CHANNEL TD IN AO 
#SD_ML IN DO (CR,LF), OR @SD_CLEAR IN DO ‘ALL? OR 
#$13,D0 #SD_PCOL IN DO {LEFT> #721,00 #5D_CLRTP IN DO (TOP) 


-MCURS 3 
3 
3 
3 
##14,D0 #SD_NCOL IN DO (RIGHT) 4 #922,00 #5D_CLRBT IN DO (BOTTOM) 
3 
4 
r 


MOVE.L OR 4(A7),40 OR B(A7) ,A0 ETE. 
CONSOLE iD IN AQ 


MOVED 


MOVED ##20,D0 


##15,D0 #SD_PRUW IN DO (UP} $$23,D0 @8D_CLRLN IN DO (LINED 
##16,D0 #SD_NROW IN DO (DOWN) #924,00 @SD_CLRRT IN DO (RIGHT) 
MOVE. INFINITE TIMEUUT INFINITE TEMEDUT 


TRAP 


MOVE.W @SFFFF,O03 
TRAP #3 


' 

j ** NOTE #* THE DATA IN AO AND DS 18 PRESERVED BY THIS ROUTINE, SO IF THE 
y NEXT CHUNK OF CODE 16 ANOTHER TRAP #3 CALL FUR THE SAME CHANNEL, THEY 

; DO NOT HAVE TO BE ENTERED AGAIN. 


3 *#* NOTE *## THE DATA IN AU AND DS IS PRESERVED BY THIS ROUTINE, SO JF THE 
NEXT CHUNK OF CODE [5 ANOTHER TRAP #3 CALL FOR THE SAME CHANNEL, THEY 
DO NOT HAVE 1U BE ENTERED AGAIN. 


1 a 
FO ae IEE Ia IIE EI EE EEE S RRERER EERE EREREREREREREEEREEEEE ER EEEREREHERER REE RAEEEARE RAED HERE 


7 Sinclair/QL World January 1992 43 


MACHINE CODE 


At 

address in A1 window width 
address in A1+2 window height 
address in A1+4 X origin 
address in A1+6 Y origin 

‘Cursor’ (Listing four) will either enable, 
or suppress, the cursor in the window, 
depending on the value in DO ($E to 
enable, and $F to suppress). 

'Positioncursor' (Listing five) will move 
the cursor to an absolute position in the 
window, using either pixel or character co- 
ordinates, depending on the value in DO 
($10 for characters and $17 for pixels). 
The word in D1 will give the new column 
number (or pixel X co-ordinate) and the 
word in D2 will give the new row number 
(or pixel Y co-ordinate). 

Where 'Positioncursor’ (Listing six) 
moves the cursor to an absolute position, 
‘Movecursor' makes a movement relative 
to the current position. The movement 
depends only on the value in DO as fol- 
lows: 


Linting 9 


I Oe NEE ER ERO CP RE HER 


“SCROLL” 


} 

5 

Ahh hhh ehhh th LLU LL TEC LET eT Tee TTT ttt 
7 SCROLLS ALL OR PART WINDOW BY THE NUMBER GF ROWS GIVEN BY THE WORD IN 

1 D1. A POGITIVE NUMBER MOVES IEXT DOWNWARDS, A TEXT WINDOW WOULD NORMALLY 
3 BE ARROLLLED UPWARDS, REQUIHING A NEGATIVE NUMBER, 

a WHICH PART OF THE WINDOW 19 SCROLLED DEPENDS ON THE VALUE IN DO, 


7 0G = $18 
3 DO #17 
3 DO = #18 


SUCRULL WHOLE WINDOW 


' 
» SCROI MUOME. L tA) ,A0 


mv #*10,D0 


MOVE.W 
MUVE. Ww 
TRAP #3 


SCROLL WINDOW ABOVE THE CURSOR LINE 
SCROLL WINDOW BELOW THE CURSOR LINE 


1 GR 4(A7),AC OR GtA7>,A0 ETC, 

3; CONSOLE CHANNEL ID IN AO 

§ WEO0_SCROL IN DO {WHOLE>, OR 

5 #*19,DO WSD_SCATP IN Dt tTOP) 

} #*1A,DO #SD SCABT IN DO iBOTTOM) 
#*FFFD,D2 5 SCROLL UP 3 ROWS 

#SFEFF OS 9 INFINITE TIMEOUT 


$12 Putcursor at the start of the 
next line (NL,CR). 

Put cursor on the previous 
column (left). 

Put cursor on the next col- 
umn (right). 

Put cursor on the previous 
row (up). 

Put cursor on the next row 
(down). 

\fthe current position of the cursor makes 
the move impossible, the command is 
ignored, and the cursor stays where it 
was. 


$13 
$14 
$15 
$16 


Overwriting 


‘Tab’ Listing seven will move the cursor 
to the column number in register D1 in the 
current row. It requires #$11 in DO. 

'Cls' (Listing eight) overwrites all, or part 
of, a window inside the current borders 
with the current paper colour. What gets 
overwritten depends on the value in DO as 
follows: 

$20 Clears the 
whole window. 

$21 Clears the 
window above the 
cursor line. 


liating 12 


ALTERNATIVE If TO USE 


Rl 


7 
$ 4s NOTE m* THE DATA IN AO AND D3 IS PRESERVED BY THIS ROUTINE, SO IF THE 
3 NEXT CHUNK OF CODE [5 ANUIHER IRAP #3 CALL FOR THE SAME CHANNEL, THEY 


a9 DO NOT HAVE TO BE ENTERED AGAIN, 
3 


iii hid ht he tee tee et ert Tee ee ed 


listing 10 


FE RF RF Fe HR TE TA HI EE a a ia ae ae 


“PON” 


Re A AE RE HE RE EE AE A a aE EE HE ar HE a RE IIE HE HO 
PANS ALL OR PART OF THE WINDOW BY THE NUMBER OF PIXELS GIVEN BY THE WORD 
IN Di. POSITIVE NUMBFRS PAN RIGHT AND NEGATIVE NUMBERS PAN LEFT. 

WHICH PART 15 PANNED DEPENDG ON THE VALUE IN DO. 


PAN WHOL & WINDOW 
PAN WHOLE CURBOR LINE 


nO so $1 
DO = *1E 
DO = #1F 

UNDER THE CURSOR 


PAN RIGHT END OF CURSOR LINE, [NCLUDING CHARACTER 


“BLOCKFIN: ' = 
MODC, BUT ONE 16 LIMITED TO CHANDING COLOURS TO THEIR KOR VALUE 
oO MOVE. 


Clears the window below 
the cursor line. 

Clears the cursor line. 
Clears the right part of the 
cursor liné up to, and in 
cluding, the character un- 
der the cursor. 

‘Scroll’ (Listing nine) scrolls all or part of 
the window by a distance given by the 
word in D1 (positive = down and negative 
= up). How much is scrolled depends on 
the value in DO as follows: 

$18 Scroll whole window, 
$19 Scroll window above the 
cursor line. 
Scroll window below the 
cursor line. 

‘Pan’ (Listing ten) pans a window side- 
ways by a distance given by the word in 
D1 (positive = right and negative = left). 
How much is panned depends on the 
value in DO as follows: 

$1B — Pan whole window. 

$1E Pan the cursor line. 

$1F Pan the right part of the 
cursor line up to, and including, the char- 
acter under the cursor. 

‘Colours’ (Listing eleven) will redefine 
the colour of the paper, strip or ink accord- 
ing to the byte in D1. Which it redefines 


$1A 


HONEA EEE EERE EEO T TET 


“RECOLOR 


i tehehiehuhahteheleded dh dkeieiah tehietdieiehdebeiebdddiia tL kkk 
THIS WILL CHANGE ALL THE COLQURS IN A WINDOW TO SOME OTHER COLOUR. IT 
ROWUIRES AN 8 BYTE BLOCK WHICH CONTAINS IHE SYTES FOR THC MEW COLOURS 
FOR COLOURS 0 TO 7 IN ORDER. 
NEED BE SPECIFTED. THIS IS A@ RATHER SLOW ROUTINE. A MUCH Faster 


IN 4 COLOUR MODE, ONLY BYTES 0, 2, 4 AND & 


OVER THE WHOLE WINDOW WHILE TN XOF 


CaF) Ao OR 4407) ,480 OF B(A7) AO ETC 


CONSOLE WINDOW ID IN AO 


##26 ,DO 
#SFPEP DS 


*8D RECOL IN DO 
TWFINITE TIMEOUT 


' 
1 
NCO AS, AL 7 NEWCOLGURS BLOCK BABE IN AL 
i 
' 


es 
NEXTHIF 7 SKIP Bonk 


ee NOTE #2 THE DATA IN AO ANN DA If PRESERVED BY THIS ROUTINE, SO IF THE 


NEXT! CHUNK OF CODE IS ANOTHER TRAP #3 CALL FOR THE SAME CHANNEL, THEY 


DO NOT HAVE TO AF FNTFRED AGAIN. 


DIUBT TO Surt weeEoOS 


-NCOLS 


weopegy 


o 
tn 
> 


= BLACK > MAGENTA 


Qeonrte 


VELLOW => BLUE 
WHITE -> RED 


FI mm I FEE IP FAR ME A EAT HAE 


Listing 13 


sshethedhithatehethihiiaiahilhiih hhh hd idee dL Leht tk. LLLLLE LLL LLL LTT 


“FLASH ' 


OR 4(A7),A0 OR OCA7) AD ETC 
LONSOLE WINDOW JD IN AO 


MOVE .b ' 
. 

¥#1B,D0 * #50 PAN IN DO (ALL), DR 
3 
‘ 


(A7) AO 
MOVE 
WS1E,00 @SD_PANLN (LINE) 
#491F,D0 WSD_PANRT (RIGHT END) 
MOVE . W #SFFFD,DE 7 PAN LEFT BY 5 PLXELS 
MOVE. Ww #4FFPF,DS 5 INFINITE TIMEOUT 
TRAP ws 
i ee NOTE «*# THE DATA IN AO AND DS 15 PRESERVED BY THIS ROUTINE, SO TF THR 
3 NEXT CHUNK OF CODE [8 ANOTHER TRAP #3 CALL FOR THE SAME CHANNEL, THEY 
; DO NOT HAVE TO BE ENTERED AGAIN. 


HIE APE EEE a A ag A nA a ea aa HEH 
Listing O12 


ts aaliaiiaelias inet eliatatahaiaetide heheheh dedddatehehehstiddidahalehhledadahsteddattadahsdadsddabsdehaeddehatatedotteh detente 
"COLOURS © 
PPAR EASE ESA EA AES HESS EEE SEE NEEE EEE HERRERO ERE RENEE HEEB REAR EERE 
REDEF INES THE COLT\IRS THE WINDOW USES FOR: — 
+ PAPER (BACKGROUND CAUSED BY CLEAR, PAN OR SCROLL), 
i STRIP (BACKGROUND BEHIND A PRINTED CHARArTER? , 
a INK (COLOUR CHARACTERS ARE PRINTED}. 
WHICH 1S REDEFINED DEPENDS OM THE Value TN DO. 
+ DO = £27 REQEFINES PAPER COLOUR 
DO ® £28 REHEFINES STRIP COLOUR 
DO = #29 REQEFINES INK COLOUR 
THe COLOUR [5 GIVEN ZY THE BYTE IN DL. 
COLOURS OWE. 1 tA7),A0 3 OR 4(@7},A0 OR (a7) AG ETC 
3 CONGOLE WINDOW 1D IN AL 
BOVEG: ws27,D0 } ¥SD_SETPA IN DO (PAPER) OR 
1} #826,D0 #6D_SETST IN DO (SIRIP) 
it WS27,DO HSD_SETIN IN DO (INK) 
i WHITE PAPER 
4 INFINITE TIHEDUT 


MOVE. & We? 01 
MOWE . #SFFFF D3 
TRAP #1 


aa NOTE #¢ THE DATA IN AC AND DS IS PRESERVED BY THIS ROUTINE, SC IF THY 
NEXT CHUNE OF CODE 95 ANOTHER TRAP #3 CALL FOR THE SAME CHANNEL, THEY 
DO MOT HAVE TO BE ENTERED AGAIN, 


SORAA ASA RA EE AA ORR ES ODS A RANE EROS NESE SEE REESE REESE EEE 
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' 
7 bs sdhialeheinhdiehihiiaiah bed ddeheiehdtdeisieieieieded ddd Ad ddt hadith nL LE LLL kth) 
; SETS THE FLASH IN @ COLOUR MODE. IF THE RYTE IN D1 19 NUN-ZERU, THEN 

7 FLASH LS SET. & ZERD BYTE IN Di MEANS FLASH IS NOT SET. 

; THIS COMMAND TS IGNORED IN 4 COLOR mone. 

5 

FLASH MOVE. L (AT},AG 4 OR 4(97),A0 OR A(A7), AD ETC 
; CONSOLE WINDOW ID 1N AG 
MOVER #828,00 5 #SD_SETFL tN DO 
MOVE .B #61,D1 i; FLASH SET 

MOVE. W SFFFF,03 ; INFINITE TRENT 


TRAP #3 


$ 

{1 #* NOTE ** THE DATA IN AO AND D3 IB PRESERVED BY THIS ROUTINE, SO IF THE 
3 NEXT CHUNK OF CODE IS ANOTHER TRAP #3 CAL FOR THE SAME CHANNEL, THEY 

3 DO NOT HAVE TO BE ENTERED AGAIN. 
3 
1 


HERE ERERAHREEEHH EERE AEE ETE HIE ee ee AE Pe HE ee aa: 
Listing 14 


Fi hehathsRadch ted sidadheddateReietatehabteteh ddiichehehsh dk Aehhded Added ddl bt itchadehod del hehdiedi.2.41.14.4.0.10 
“UNDE RL LINE * 

Pll hat hell deh keh Dh Rebdad deh tehieteiehctetet ehh deh Add Ad hdd dhe hd kdalalehdukeksdakoksntohed 
SETS UNDERLINE MODE FOR PRINTED CHARACTERS. IF THE BYIE IN Dl 19 NON- 

; ZERO, CHARACTERS WILL BE UNDERLINER. IF THE BYTE IS ZERO, THE CHARACTERS 
WILL NOT BE UNDERLINED 

UNDER MOVE. L 18s>,80 5 UN 41A/),80 OR BLA) ,A0 ETC 

| CONSOLE WINDOW ID IN AO 

Moveg #828,00 3 #5D_SEIUL IN Lo 

MOVE. B #41,D1 | BET UNDERLINE MODE 

MOVE. Wl WEFFFF DS ; INFINITE FIMEQUT 

TRAP #3 : 


7 

j ** NOTE ** THE DATA IN AQ AND D3 1S PREGERVED BY THIS ROUTINE, SO IF THE 
i NEXT CHUNK fF CODE 18 ANOTHER THAP #3 CALL FOR THE SAME CHANNEL, THEY 

; DO NOT HAVE TD BE ENTERED AGAIN. 


SR EH HE HE eT EE HE EAE AE EAE SE fA 
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MACHINE CODE 


depends on the value in DO as follows: 
$27 Redefine paper colour 
$28 Redefine strip colour 
$29 Redefine ink colour. 

‘Recolour’ (Listing twelve) will recolour 
every pixel in the window to a new colour 
given by an 8-byte conversation list, the 
base of which has its address in A1. It 
requires $26 in DO. 

This is a very flexible command, but is 
also slow. A much faster (but somewhat 
restricted) alternative is explained under 
'Blockfill’. 


Flashing 


‘Flash’ (Listing thirteen) only works in 8 
colour mode. If the byte in D1 is non-zero, 
then subsequently printed characters will 
be flashing, until the byte in D1 is made 
zero, when any further characters will not 
be flashing. Requires $2A in DO. 

If the byte in D1 is non-zero, 'underline' 
(Listing fourteen) makes subsequently 
printed characters underlined, until the byte 
in D1 is made zero, when any further 
characters will not be underlined. It re- 
quires $2B in DO, 

‘Writemode’ (Listing fifteen) redefines 
how the strip and ink colours are inter- 
preted on the screen, depending on the 
word in D1 as follows: 

-1 Ink colour is XORed into the back- 
ground. 

0 Normal printing in ink colour on strip 
colour. 

1 Printing in ink colour on a transparent 
strip which does not overwrite the back- 


Listing 15 


EO Oe EERE REA PER EES EEE OEE EE ROE Ee 


"WRITEMODE ' 


AEE EEE EE REESE EEE LETTE EEE EERE Re 
REDEFTINES HOW THE CHARCTERS AND BACKGROUND ARE "D0 BE PRODUCED BY THE 


IN Di. 
-1 INK 19 XOR CURRENT BACKGROUND 


O WRITE IM INK COLOUR ON STRIP COLOUR BACKGROUND 
1 WRITE IN INK COLOUR ON A TRANSPARENT BACKGROUND 


MOVE. 4A?) , AD 
MOVER 
MOOVE . bd 
MOVE. 
KAP 


W#20,D0  j 
WOFFFFYDE 5 
WSFFFF,DS { 
Ws 


7 OR 44A7},AO DR B{A7},AO ETC 
} CONSOLE WINDOW TD IN AO 
#SETMD IN LO 

WOR INK INTO BACKGROUND 
INFINITE TIMEOUT 


ground. 

It requires $2C in DO. 

‘Csize' (Listing sixteen) (surprise, sur- 
prise!) redefines the character size. It re- 
quires $21 in DO, and will set the width 
depending on the word in D1, and the 
height depending on the word in D2, as 
follows: 

In D1 

0 Spixel width (single) in 6 pixel space. 

1 5pixel width (single) in 8 pixel space. 

2 10 pixel width (double) in 12 pixel 
space. 

3 10 pixel width (double) in 16 pixel 
space. 

in D2 

0 9 pixel height (single) in 10 pixel 
space. 

1 18 pixel height (single) in 20 pixel 
space. 

It should be noted that in 8-colour mode, 
only double-width characters are allowed, 
and the QL will interpret a 0 in D1 as a 2, 
anda1inD1asa3. 

‘Blockfill' (Listing seventeen) will fill a 
rectangular block inside the windows with 
a colour given by the byte in D1. It requires 
$2E in DO, and in A1 the base address of 8 
bytes containing the block details as fol- 
lows: 

Base _ Width in pixels. 

Base + 2 Height in pixels. 

Base + 4X Origin of block (relative to 

window). 

Base + 6 Y Origin of block (relative to 
window). 

There are two special applications of this 
command that make it particularly useful 
because of its 
speed. 

A long, thin block 
will draw a horizon- 
tal or vertical line 
much more quickly 
than normal line 
plotting will. 

If 'Writemode’ is 
set to XOR mode, 
then all the colours 


listing 17 


currently in the block will be XORed with 
the colour given by the byte in D1. Al- 
though this is not a completely general 
recolour command, it gives quite a lot of 
choice, and is much faster than ‘Recolour’, 
particularly when handling large areas of 
the screen. 

Now to try out some of this. Clearly, an 
application which used all of these chunks 
of code would be very unusual indeed! 
Perhaps you could try modifying the pro- 
gram we put together in part two, by mak- 
ing the display it produces more user- 
friendly, or prettier, or more bizarre if that's 
what turns you on! 


interactively 


| expect, though, that if you are going to 
try out this material, you probably want to 
do it interactively, like Basic. Like most 
people brought up to do interactive Basic, 
| write a bit, test it, write a bit more, test it. 
.. 6tc. In Basic, this presents no problem, 
because if it doesn't do what you wanted, 
the worst that happens is an error mes- 
sage. 

Machine code programs that don't work 
properly usually crash the machine, or at 
least leave you with lots of unwanted open 
channels clogging up the system so it 
needs a reset. 

The trick of writing interactively is to write 
the start and finish first, that is 'SOBSTART' 
and 'ENDJOB'. A program consisting of 
just this won't do anything, but it won't 
crash the QLeither. Next, inbetween those, 
we put 'CONSOLE'’ to open a window, and 
‘CLOSE' to close it. Now we have a ‘do 
nothing’ channel, but still it won't crash. 
Now, inbetween 'CONSOLE' and 'CLOSE' 
we can do what we like with the window, 
and provided we get all the BRA.S com- 
mand right to make ita continuous program, 
we can play around until we get what we 
want. 

Next time, we shall look at some of the 
things we can do with these screen control 
commands to produce interesting effects. 


i 

) ** NOTE ## THE DAIA IM AO OND NS IS PRESERVED RY THIS ROWITINE, SO IF THE 
) NEXT CHUNK OF CODE IS ANOTHER TRAP #3 CALL FOR THE SAME CHANNEL, THEY 

) DO NOT HAVE 10 BE ENTERED ABKIN, 


s diataelchatiaiatiateiaisiatehshaiahdieiidebdehddiedhinietamitatiiiiedsbehaiedalatoddteed cored tn LLL GL) 
*BLOCKFILL* 
| Mi cliaiaccdeiacietiadicticiaatsieiatehatetateiatelehihaisteielaieiedsieieiehelaleldutahtututakatukaldahatet dated hdc cL) 
3 THIS FILLS A RECTANGULAR BLOCK WITHIN THE WINDOW. 
THE COLOUR IS GIVEN BY THE BYTE IN D1. 
THE DATA FOR THE BLOCK TO BE FILLED IS IN AN & BYTF EFINITION BLOCK 
CALLED BLOCK’ AS FOLLOWS: - 
* BASE BLOCK WIDTH IN PIXELS 
3 BASE + 2 BLOCK HEIGHT IN PIXELS 
> BASE + 4 X ORIGIN GF BLOCK (RELATIVE TO WINDOW ORIGIN? 
BASE + & ¥ ORIGIN OF BLOCK (RELATIVE TO WINDOW ORIGIN} 
3} THE BASE ADDRESS OF BLOCK MUST BE IN Al. 


i 
fe EE SEE E EE EE REESE ERT ET EEE RERE ARERR EERE ERE EERE RE RENE ERE E 


Listing 14 


REE A A FR EE A I 
“CSIZE 

; KEENE EEE CREAT CERO PETAR TESTER EHS ee 

3} REDEFINES THE CHARACTER SIZE AND SPACING. 

3 THE WORD IN D1 SETS THE CHARACTER WIDTH/SPACING AS FOLLOWS: — 

5 D1 = O SINGLE WIDTH (5 PIXELS) IN 6 PLXEL SPACE 

3 01 = 1 SINGLE WIDTH (5 PIXELS) IN & PIXEL SPACE 

y DOL & 2 DOUBLE WIDIH 110 PIXELS) TN 12 PIXEL SPACE 

¢ Di = 3 DOUBLE WIDTH (10 PIXELS)? IN 16 PIXEL SPACE 

¢ 8 COLOUR MODE CAN ONLY SUPPORT DOUBLE WIDTH CHARACTERS, SO DL = 0 WILL 

3 BE TREATED AS D1 = 2, AND Di = 1 WILL BE TREATED AS Di = 3. 

3 THE WORD IN D2 gk fs THE CHARACTER HEIGHT/SPACING AS FOLLOWS: - 

; D2 = 0 SINGLE WEIGHT (7 PIXELS) IN 10 PINEL SPACE 

y D2 = 1 DULBLE HEIGHT (18 PIXELS) IN 20 PIXEL SPACE 


MOVE.L (47) AO OR 4(A7)4AO OR BA?) AC ETC 
CONSOLE WINDOW ID IN AO 
LEA BASE ADDRESS DF BLOCK IN Al 
MOVED 
MOVE. B 
BOVE.Ww 
TRAP 


BRA.S 


cy 
' 
BLOCK ,AL 3 
#$2E,D0 4 WSD_FILL IN DO 
* RED BLOCK 
5 


INFINITE TIMEOUT 


#92,D1 
WSF FFE DS 
as 
NEXTBIT ; SKIP BLOLK 
#4 MOTE ## THE DATA IN AQ AND US 15 FRESERVED BY THIS ROUTINE, SO IF THE 
NEXT CHUNK OF CODE IS ANOTHER TRAP #2 CALL FOR THE SAME CHANNEL, THEY 


OR RAT) SOL, DE BLT gO ETS ; DO NUF RAVE TU BE ENTERED AGAIN, 


CONSOLE WINDOW ID IN ao 

3; #5D_SETSZ IN DO 
WIDTH 10 IN 42 PIXEL SPACE 
HEIGHT 18 IN 20 PIXEL SPACE 
INFINITE TIMEGUt 


é 
«CSIZE PUVE.L (A?) ,Alr 
MOVE 
MOVE. 
MOVE. 
MOVE . iW 
TRAP 


#3zD,D0 ** NOIE ** APART FROM SIMPLY FILLING A BLOCK WITH A COLUUR, 


USED IN THO OTHER WAYS. 

3 2. LUNG [THIN BLUCKS WILL DRAW HUR]ZONTAL OR VERTICAL LENES. 

32. WITH WRITEMODE SET TO ‘'XOR', IT WILL RECOLOUR A BLOCK OR WINDOM, 
THESE HAVE THE ADVANTAGE OF BEIM FASTER THAN THE CONVENTIONAL WAYS. 


IHLS CON BE 


a8 NOTE ®* THE DATS IN AO AND DS IS PRESERVED BY THIS ROUTINE, SO IF THE 
; NEXT CHUNK OF CODE IS ANOTHER TRAP #3 CALL FOR THE SAME LHONNEL, THEY 
BO MOT HAVE TO BE ENTERED AGAIN. 


bC.W 254 
DC.W 64 
De. w i) 
DC.W ° 


- BLUCE. 3 256 PLMELS WIDE 
1 64 PIXELS HIGH 


1 AF 1HE WINDOW ORIGIN 
EE EEE EERE EH EEE E ER SRE SER RETA 


3 
7 PER AREE RENEE EEE N EERE REE EE EEE CREE RR RR EEE 
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Title: Professional and 
Business Uses of the QL 
Author: Colin Lewis 
Publisher: Collins 
Profesional, 1985 
Price: £7.95 in 1985 
Available: Fairs 
second-hand 

QL Specific: Yes 


and 


tits launch the OL was 
seen by many small 
businessmen and 
self-employed pro- 
fessionalsas the very thing they 
needed — a work-orientated, 
affordable, small computer that 
could bring more efficient han- 
dling of paperwork. 

At the same time these OL 
buyers were far too busy to 
spend weeks learning to pro- 
gram-—orevento wade through 
the heavy instruction manual 
supplied with the machine and 
it was for these users that Colin 
Lewis brought out his book 


Professional and Business Uses of 


| the QL in 1985, The book cost 
£7.95 at that time and was pub- 
lished by Collins. 

The book didn’t claim to say 
anything really new about the 
OL. It simply concentrated on 
the bundled software package 
supplied with the machine and 
showed how it could be put to 
immediate use in a business 
environment. 

At that time I was a freelance 
journalist looking to replace an 
ageing typewriter witha word 
processor and to develop a 
computer-based filing system 
to keep track of my work 
placement and this book very 
soon became my QL bible. 


The book began with the set- 
ting up of the hardware and its 
linkage to an Epson-type 
printer and, as it was dealing 
with the QL as supplied, all the 
practical applications listed in 
the book were set up to be run 
using microdrives. After the 
setting up procedures had been 
explained the book outlined the 
very minimum knowledge that 
was needed to use Qdos and 
then launched into the practi- 
cal applications of Quill. 

All the author needed to do 
here, of course, was to show 
how a wordprocessor could 
replace the office typewriter 
and he finished up his dem- 
onstration with a sample price 
quotation using right and 
decimal tab stops. The next 
chapter, dealing with Abacus, 
gave several practical examples 
of the spreadsheet’s use - in- 
cluding building an Investment 
Portfolio, a Break-even Analy- 
sis spreadsheet and also one 
dealing with cash flow analy- 
sis and the production of a 
document that could be pre- 
sented by the director of a small 
company to his bank manager 
when needing loan facilities. 

Easel, which the author re- 
gards as quite a useful busi- 
ness program, is covered very 
thoroughly in the book but, for 
me, his explanation of Archive 
and its practical business ap- 
plications was the most useful 
thing of all. It is quite amazing 
how many QL owners never 
use Archive because they are 
convinced it is over compli- 
cated. Although [ am strictly a 
non-technical person I found 
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myself building up some 
highly sophisticated databases 
by following the examples in 
this book. For some it could be 
worth getting the book for this 
application alone. 

Forany businessman already 
using the four packaged pro- 
grams on a regular basis, 
however, this book would 
probably be of little value at 
the present time. If a similar 
book could be written today 
outlining the business possi- 
bilities of a OL which has an 
add on disk-drive and ex- 
tended memory and for which 
several business and accounts 
programs have been produced 
— now, that really would be 
useful. 

David Drysdale 


Elementary 


Title: Exploring the Sinclair 
QL — An Introduction To 
Super Basic 

Author: Andrew Nelson 
Publisher: Interface 
Publications, 1984 

Price: £4.95 in 1984 
Available: Fairs, or 
second-hand 

OL Specific: Yes 


his book is just what it 
calls itself: anintroduc- 
tion to SuperBasic and 
an elementary one at 
that. | bought it at the time 
when the first functioning (ie 
AH) QLs were being unveiled 
to the public. Not surprisingly 
then, the book carries a com- 
puter health-warning being 


‘based on use of pre-release OL 
computers’, and goes on to 
caution the reader to check the 
User Guide if problems arise, 
For example, Nelson describes 
how to get the Ascii code of the 
character “A” by thestatement: 
PRINT CODE “A” instead of 
PRINT CODE (“A”), although 
he does get it right in an Ap- 
pendix. 

Following a brief tour of the 
QL hardware, the greater part 
of the book describes the range 
of SuperBasic commands 
available and their use in pro- 
gramming. Nelson is a firm 
believer in the merits of the 
structured approach. In gen- 
eral, his descriptions are clear 
and concise without getting 
bogged down in unnecessary 
detail. 

His presentation of the main 
elements is logical, starting 
with simple commands, then 
introducing control statements, 
arrays and strings, procedures 
and functions, and finally 
graphics. Towards the end, 
there is a very sketchy account 
of Qdos and channels. 

Insome ways, the book reads 
like an account of the 
SuperBasic we might have had 
with, for example, a fascinat- 
ing description of array literals, 
edit-mode overwriting, and 
keywords such as INVERSE 
and TRACE which were never 
implemented by Sinclair Re- 
search. Also, the syntax of a 
number of keywords has 
changed since the earliest ver- 
sions were released, a fact | 
which rather lets the book 
down. 

I found the discussion of how 
screen colour output is con- 
trolled muddled and confusing 
and also his treatment of out- 
put ‘devices’ and channels 
which, rather unfortunately, he 
refers to as pipes. The example 
programs given throughout 
the book are extremely el- 
ementary,,none of them doing 
anything at all useful. 

Therearea few niggles I have 
about the book as well, eg, the 
blank, butnumbered, pages be- 
tween chapters giving the 
impression of sections being 
left out; the large number of 
space-wasting photographs of 
the OL (including one of the 
infamous ‘kludge’ or ‘dongle’), 
the unnecessary discussion of 
monitor-lead pin-connections 
on pages 4 and 5, not to men- 
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tion the jaded innuendo in the 
section on graphics. 

With its unfussy approach 
and clear style, the book has 
some merit as a simple 
introduction to programming 
in SuperBasic. However, there 
are far too many inaccuracies 
in it to recommend it any more 
highly than that. 

Nigel Bates 


From 
Uppsala 
to 
Apple 


Title: Electronics Handbook 
Author: JorgedeSousa Pires 
Publisher: Chartwell-Bratt 
Price: £39.95 

Available: Currently in 
print 

QL Specific: No 


his book of just over 

eight hundred pages 

covers a wide range 

of electronics and re- 
lated subjects. [tincludes some 
relevant basic physics and 
mathematics, analogue 
circuits, digital circuits, com- 
puter hardware and computer 
software. 

Theauthor was associate pro- 
fessor of semiconductor 
physics at Uppsala University 
for 15 years, and now works 
for Apple Computer. Nodoubt 
this experience explains the tre- 
mendous range which he 
covers convincingly. 

The book is aimed at stu- 
dents, and it is structured to 
enhance its function as a text- 
book. Subject areas are split 
into small sections, which are 
not contiguous. A section typi- 
cally covers a limited subject 
area from basic to advanced 
level, and may include notes 
on what the teacher /lecturer 
should do to supplement the 
information in the book. 

The author has included a 
section on ‘Pedagogics’ in 
which heexplains among other 
things that the book is intended 
to promote understanding of 
the subjects rather than simply 
teach the relevant mathemat- 
ics. It should achieve this aim. 
Certainly the sections which I 
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studied in detail made good 
sense and were as straightfor- 
ward as the subject matter al- 
lowed. 

The book is well indexed for 
its use as a textbook, but not so 
well for use asa reference book. 

Inaddition toareas normally 
covered by this kind of book, 
the author has included some 
short notes on related subjects 
such as astronomy and music. 
Peripheral subjects are also 
touched on in individual sec- 
tions, so | learnt when reading 
about signature analysis for 
testing microprocessors, that 
the word comes from the Latin 
- signatura — the marking of 
sheep for identification. So you 
can count microprocessors in- 
stead of sheep. 

This is nota specialised com- 
puter book. Most long term QL 
users probably already know a 
large proportion of what the 
computer section contains, and 
considerably more about soft- 
ware. The subject is covered 
sufficiently well, however, that 
almost everyone will discover 
something new to them. 
Among QL World readers, 
those interested in general elec- 
tronics should look this book 
over. It will provide a worth- 
while depth of information for 
people interested in how their 
computers function as well as 
how to program them. 

On thecomputing front, there 
are many examples of Basic 
programs included in other 
sections. Bode plots and cal- 
culation of conic sections are 
two examples of this. There is 
also a section about how to 
write better and faster Basic 
(not, of course, specifically 
SuperBasic). Operating sys- 
tems and assemblers are also 
covered in short sections, but 
these are only introductions. 
Most computer topics are at 
least touched upon, with a 
worthwhile sectionon modems 
as one example. 

Spreadsheet calculations are 
also used as examples, and 
typical printouts show an Ap- 
ple-based package. Most or all 
of the calculations would be 
possible on other spreadsheets, 
though, with only some of the 
graphics not being universally 
available. 

My only specific criticism is 
that, in covering digital circuits, 
the author has used the un- 
popular IEC logic symbols, in 
which all gates are drawn as 


rectangles. Symbols written 
inside the rectangle define the 
gate type, so that the function- 
ing of a logic circuit is not clear 
ata glance, asit usually is when 
using the ANSI (American) 
symbols. 

Taking a final lucky-dip of 
subject headings from the book 
to give an idea of its scope, we 
come across decibels, scientists 
and historical facts, noise re- 
duction, astronomy, Laplace 
transform, vectors, Boolean al- 
gebra, debouncing, Morse 
code, DTMF tones, world tv 
and Mesh analysis alongside 
the more obvious electronics, 
computing and comms head- 
ings. ; 

The Electronics Handbook 
would also be a useful source- 
book for anyone studying fora 
qualification in electronic or 
electrical engineering, or for 
electronics specialists needing 
a reasonable depth of back- 
ground knowledge outside 
their specialism. 

The price will tend to rule it 
out for the idly curious, but the 
serious student or enthusiast 
will appreciate it. 

Andrew Armstrong 


Worlds 
from 
Scientific 
American 


Title: The Armchair Universe 
Author: A K Dewdney 
Publisher; WH Freeman, 
Oxford 

Price: £12.95 

Available: Currently in 
print 

QL Specific: No 


s I learned how to 
program a compu- 
ter, there often came 
times when I would 
consider exactly which prob- 
lems I might choose to solve 
with my new found skills. I 
would deriveas much pleasure 
from small programs that 
would perform simple jobs as I 
might from far more complex 
(and often long since aban- 
doned) projects. Tasks such as 


attempting to find meaningful 
anagrams of words —or indeed 
even ones that could be pro- 
nounced at all provided both 
entertainment and improved 
my ability to write programs. 

One useful source of ideas 
for such programs was, and 
indeed still is, Scientific 
American, Anyone who has 
found interest in Mandelbrots, 
artificial intelligence, the game 
of ‘Life’ and similar computer 
related activities is likely at one 
time to have read A K 
Dewdney’s Computer Reerea- 
tions columns in this magazine. 

This book represents a col- 
lection of the subjects detailed 
by Dewdney in hisarticles. The 
first to be produced, itrecounts 
in just over three hundred 
pages, some of the topics cov- 
ered between 1984 and 1987. 

The style is light and highly 
illustrative, with most themes 
being introduced through im- 
aginative descriptions of the 
processes involved. It is not to 
be read through from 
beginning to end, though. The 
many, often wildly different 
ideas are best picked up indi- 
vidually when their descrip- 
tions have aroused your 
interest. 

To this end, the book is 
divided into sections - different 
‘Worlds’ — each with its own 
introduction. These include the 
worlds of Infinite Graphics, Ar- 
tificial Intelligence and 
Mathemagadgets amongst 
others — which in turn take in 
respectively Mandelbrots, the 
well known Eliza programand 
devices made of spaghetti. 
Each world covers a number of 
subjects which are clearly de- 
scribed and illustrated, either 
in diagrams or the central 
colour pages. The descriptions 
take care not to become too 
complex, nor to use 
mathematics beyond basic 
algebra. In some cases, where 
concepts that might be new to 
the reader are introduced, it 


- mighthelp to havea penciland 


paper to hand — however 
Dewdney takes these descrip- 
tions slowly and treats them 
with a disarming humour. 

If, as is often the case, a 
computer program might be 
developed from the discussion, 
this too is described. The de- 
scriptions have no listings 
within them (bar one itinerant 
Apple program), but instead 
list each step that must be per- 
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formed in turn. The process of 
translating this into a program 
is relatively simple and in any 
case best left to the reader, so as 
to suit his particular computer 
set-up. 

Other worlds covered by the 
book include ‘Life In Au- 
tomata’, ‘Puzzles and Word- 
play’, ‘Stimulation through 
Simulation’ and ‘Core Wars’ — 
the last being the fascinating 
area of battling computer pro- 
grams, The sections are com- 
plemented by a full index, a 
bibliography and a list of 
sources of further information 
and software (the latter being 
largely based in America and 
intended for the IBM PC). 
Overall, the book is well 
thought out and written. It 
presents any number of both 
new and old topics very clearly 
and is to be recommended. 
Andrew Toone 


C: 
Portable 
from the 
general 

to the 
specific 


Title: C: A Dabhand Guide 
Author: Mark Burgess 
Publisher: Dabs Press 
Price: £14.95 paperback 
Available: Currently in 
print, other books in series 
QL Specific: No 


his is one of a series 

of computer books 

set out in a similar 

format, and is prima- 

rily intended as a tutorial, with 

only a slight knowledge of 

computing in a language such 

as Basic assumed. The book 

starts with the basic concepts of 

high and low-level languages, 

the differences between com- 

pilers and interpreters, pro- 

gressing in easy stages with 

plenty of example listings and 

diagrams as new keywords and 
concepts are introduced. 

Some of the topics covered 


are Pre-processor, Libraries, 
Parameters, Local and Global 
variables, Pointers, Functions 
and Macros, Bit Operators, 
Data Structuresand Recursion. 
Don’t be put offif you have not 
heard of some of these terms, 
they are introduced gradually, 
and each chapter finishes with 
a series of questions to check 
your understanding of the 
chapter — the answers are in 
one of the appendicies at the 
back of the book. 

The examples culminate to- 
wards the end of the book ina 
listing of useful toolkit routines 
covering console input and 
output, complex numbers, and 
linked list data structure. There 
arealsotwocomplete program 
listings, a statistical data han- 
dler utility (calculates the 
mean, standard deviation etc. 
from sets of data), and a vari- 
able cross referencer (produces 
a list of all the identifiers — 
variables etc. with line num- 
bers within a source file. 

The index is fairly extensive 
so when the language is mas- 
tered the book would still be 
useful for reference. Of neces- 
sity the text is not machine 
specific. (C is meant to be a 
very portable language) how- 
ever towards the end of the 
book there are chapters detail- 
ing the peculiarities of C in re- 
lation to several machines 
Amiga, Atari ST, Archimedes, 
PC, and BBC Master, though 
unfortunately nothing specific 
to the QL. 

There are program disks 
available to accompany this 
book in the same five formats 
as mentioned above. The pub- 
lisher has informed me that the 
current priceis£7.95 but further 
information can be obtained 
from Dabs Press on 061 773 
8632 (this is a more recent 
number than that given in the 
book). 

[have been working through 
this book using DP’s PC 
Conqueror with the shareware 
program Personal C Compiler to 
compile the examples without 
any major problem. I have also 
tried the listing using Digital C 
Special Edition compiler with 
less success, as Digital Cis only 
a subset (based on Small-C) of 
the complete C language. 

C: A Dabhand Guide is a well 
presented and easy to follow 
tutorial text that can later be 
used for reference. 

John Langford 
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Words for 
people who 
like getting 
to the heart 

of things 


Title: Inside the Sinclair QL — 
an introductory guide to the 
hardware 

Author: Jeff Naylor and 
Diane Rogers 

Publisher: Sunshine Books 


(Scot Press) 1985 

Price: £6.95 in 1985 
Available: Fairs or second- 
hand 

QL Specific: Yes 


ost computer us- 

ers are one of 

two types: the 

timid sort con- 
tent to run someone else’s soft- 
ware which does what they 
want without anything going 
seriously wrong, and the sort 
who are fully conversant with 
machine code, instruction sets, 
and microprocessor architec- 
tures and who see computers 
as things to be taken apart, de- 
bugged and reassembled like 
the parts of a car. 

Nonetheless, I suspect there 
are numerous OL owners who 
long for the day when they 
might leap the gap between 
novice user and informed ex- 
pert. If you're one of these, then 
this book is as good a place to 
start as you could find. Naylor 
begins with the most elemen- 
tary principles of electronics 
and builds up to a fairly de- 
tailed description of the QL ar- 
chitecture and hardware, and 
the Motorola 68008 instruction 
set. 

The book is divided into two 
sections, the first of which deals 
with the fundamental princi- 
ples of electricity, digital cir- 
cuits, logic gates, sound and 
image production, and mag- 
netic recording of data. After a 
clear and concise account of 
number bases, the book illus- 
trates the main components of 
a hypothetical microcomputer 


architecture: central processing 
unit, buses, memory devices, 
keyboard, and video circuits. 

Then follows a detailed look 
at the inner workings of a typi- 
cal cpu through its various 
buses, registers, program 
counter, stack pointer, and the 
way in which the cpu obeys 
instructions, fetches data, ad- 
dresses memory and othersuch 
operations. 

The second section describes 
the detailed make-up of the QL, 
in relation to the principles al- 
ready outlined. A brief account 
of the 68008 processor itself 
leads intoanextensive reference 
section on the 68008 instruction 
set. The author takes the MOVE 
instruction as an example to 
describe such things as syntax, 
opcode and the effect of the in- 
struction of the various flags. 

From here, the book explores 
machine code in a few simple 
routines which, however, only 
succeeded in locking up my 
(expanded) QL. Naylor in- 
cludes a simple monitor pro- 
gram to examine and alter 
memory addresses, save and 
call code and carry out number- 
base conversions. 

There are detailed descrip- 
tions of the physical and soft- 
ware memory maps, the video 
display, the 8049 processor, 
keyboard, CTL and serial sock- 
ets, sound, a very skimpy sec- 
tion on networking, and a de- 
scription of the microdrive fil- 
ing system. 

Finally, in a chapter entitled 
‘Software Maketh the Machine’, 
the author describes Qdos traps 
and vectors, and exhorts the 
reader to try out things for 
himself, 

The textis well written, thanks 
also to the literary contribution 
of Diane Rogers which the blurb 
on the back cover acknowl- 
edges. There were a few occa- 
sions, however, when a picture 
(or two) certainly would have 
been worth a thousand (or 
$3E8!) words. Having said that, 
I will admit that I did come 
away with a better feel, at least, 
for how my QL ticks. 

However, you'll need to read 
this book more than once if this 
is your first attempt at breaking 
into the inner circle of compu- 
ter aficionados. In those other 
immortal words of Abraham 
Lincoln, ‘People who like this 
sort of thing will find this the 
sort of thing they like.’ 

Nigel Bates 


Dilwyn Jones Computing 


41 Bro Emrys, Tal-y-Bont, 
Bangor, Gwynedd LL57 3YT 
Tel: Bangor (0248) 354023 


COCKTAILS WAITER 

Christmas is coming, as we all know! If you keep drinks in 
the house over the festive season, why not let this program 
conjure up a cocktail or two when you hold a party or have 
friends and relatives round. A database of 400+ recipes is 
supplied as standard - further recipe sets are also available 
(see below). Needs at least 256k of memory to run. Tell it 
which ingredients you have handy and it will give you a list 
of cocktails you can make with those drinks! Great fun. 

On disk £10.00 on 2 cartridges £12.00 

MIX2 - hundreds of extra recipes £5.00 
MIX3 - still more recipes, including many non- 

alcoholic drinks! £5.00 


FLOPPY DISKS, ETC... 


Make sure you have enough floppy disks, labels, storage 
boxes, etc to last the Christmas and New Year period. 
Contact DJC for any items you may need, and don't forget 
we Can now accept telephone orders if you wish to pay by 
Visa/Access/Mastercard/Eurocard credit cards for quick 
delivery, subject to items being in stock. 
3.5" unbranded floppy disks (DSDD) 

(with labels} 20 or more 
Standard 3.5" disk labels, roll of 100 
3.5" labels on tractor feed roll of 100 
5.25" DSDD unbranded disks 
Box to hold 40 3.5" disks 
Box to hold 80 3.5" disks 
Posso box, holds 150 3.5" disks f 
Disk box subject dividers, set of 20.0.0... £3.00 
Monitor stand, for 12° or 14° monitors 
Small plastic box for 10 3.5" disks 
Microdrive cartridges 
Cartridge labels, roll of 100 labels 
Address labels on tractor fed roll 100 


PLEASE ADD POSTAGE AND PACKING AT THE RATES 
SHOWN ON PAGE 2 FOR THESE ITEMS 


SLOWGOLD 2by Norman Dunbar and Phil Borman 
Slowgold 2 is a utility for slowing down programs running 
too fast on a Gold Card (although it can also be used on 
a standard QL if required), There are two versions of 
Slowgold - one interrupt driven routine for slowing down 
the whole computer and a new version that can selectively 
slow down individual programs when several are in use at 
the same time (which the Gold Card’s SLUG command is 
not able to do). A bargain at only £5.00! 


= E 


EUROCARD 


are 


“THE CAT" 


The Cat is a BASIC extension that prints to the screen or 
printer a tidy list of files on a disk or cartridge in columns to 
save the frustration of only being able to see a small 
number of files at a time on screen or printing several 
sheets of paper just for the one list of files. Installs itself as 
a SuperBASIC extension, so it stays even after a NEW, etc. 
On disk ONLY £5.00 or on Cartridge ONLY £7.00 


SCREEN SNATCHER 


Capture screen displays from other programs on the QL. 
Ashort multitasking routine sits alongside other programs 
waiting for you to press a key combination you define, 
when it springs into action and saves a snapshot of the 
current display to disk, ramdisk ror microdrive, so that you 
can load it into another program for printing if required, or 
so that it can be included in a Vision Mixer presentation if 
required. We use it to include screen shots in our catalogue, 
for example. 
On disk £10.00 on cartridge £12.00 


QL GENEALOGIST Second Edition 


The enhanced version of the very popular QL Genealogist 
program. Now with improved research reports, new Geog- 
raphy section, improved Notes facility, TREE outputs, 
compatible with version one data files, and many more 
minor improvements to many parts of the program, In- 
cludes a tutorial chapter in the manual to help get you 
going with the program. Upgrade terms available for 
buyers of the first version, and a conversion service is 
available from the author for those who currently use 
Archive to record family history who wish to move up to this 
program. 

GENEALOGIST Second Edition (disk only) 
Standard Genealogist (while stocks last) 
Budget128k Genealogist on microdrive £12.00 
Budget 128k Genealogist on disk £10.00 

Archive _dbf file conversion service - ask! 


£30.00 
£19.50 


PICTUREMASTER, the screen making utility 
for use with out Vision Mixer programs, has been signifi- 
cantly upgraded, Please contact us for details and our 
upgrade terms. 


COMING SOON IN THE NEW YEAR 
Upgrades to Page Designer 2 and Image Processor 
(formerly sold by Sector Software), Contact us for full 
details and prices. 


PAYMENTS - We are now able to accept payment by Mastercard, 
Access, Visa or Eurocard credit cards as well as the methods listed 
in our advert on page 2. 


